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12  hours  for  the  1-D/2-D/3-D  flow  and  transport  example. 
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Figure  4.87.  The  concentration  distribution  of  particulate  chemicals  on  overland  at  time  - 
12  hours  for  the  1-D/2-D/3-D  flow  and  transport  example. 

Figure  4.88.  The  concentration  distribution  of  the  adsorbing  site  and  adsorbed  chemicals 
[g/m3]  in  the  subsurface  at  Time  =12  hours  for  the  1-D/2-D/3-D  flow  and 
transport  example. 

Figure  1.1  Specification  of  3-D  element  sides. 
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Section  1.  INTRODUCTION 


This  report  is  to  present  a  numerical  model  designed  to  simulate  water  flow  and  chemical  and 
sediment  transport  in  watershed  systems.  This  watershed  model  includes  a  1-D  river/stream  network  flow 
module,  a  1-D  river/stream  network  transport  module,  a  2-D  overland  flow  module,  a  2-D  overland  transport 
module,  a  3-D  subsurface  flow  module,  and  a  3-D  subsurface  transport  module  to  link  surface  and  subsurface 
systems  through  infiltration/seepage.  This  watershed  model  can  be  used  to  simulate  flows  alone,  sediment 
transport  alone,  reactive  chemical  transport  alone,  or  flow  and  sediment  and  reactive  chemical  transport 
simultaneously.  This  model  can  read  flow  fields  computed  from  either  its  flow  module  or  other  flow  models 
to  proceed  transport  simulations.  When  both  flow  and  transport  are  simulated,  the  flow  fields  are  computed 
first.  Then  the  transport  is  calculated  using  the  computed  flow  fields  at  respective  times.  The  feedback  of 
transport  on  flow  is  not  considered  (e.g.,  no  density  effect  is  considered)  in  this  model. 

There  may  be  three  approaches  to  model  surface  flow  in  a  watershed  system:  the  kinematic, 
diffusive,  and  dynamic  wave  models.  The  dynamic  wave  models  completely  describe  water  flow  but  they 
are  very  difficult  to  solve  under  some  conditions  (c.g.,  when  the  slope  of  ground  surface  is  steep),  regardless 
of  what  numerical  approach  is  employed.  On  the  other  hand,  the  diffusion  and/or  kinematic  models  can 
handle  a  wide  range  of  flow  problems  but  are  inaccurate  when  the  inertial  terms  play  significant  roles  (e.g., 
when  the  slope  of  groundwater  surface  is  small).  Thus,  three  options  are  provided  in  this  report:  the 
kinematic  wave  model,  the  diffusion  wave  model,  and  the  dynamic  wave  model  to  accurately  compute  water 
flow  over  a  wide  range  of  conditions.  The  diffusion/kinematic  wave  models  were  numerically  approximated 
with  the  Lagrangian  method.  The  dynamic  model  was  first  mathematically  transformed  into  characteristic 
wave  equations.  Then  it  was  numerically  solved  with  the  Lagrangian-Eulerian  method. 

The  subsurface  flow  governing  equations  are  discretized  with  the  Gelarkin  finite  element  method. 
The  surface/subsurface  interface  boundary  is  treated  as  a  variable  boundary  as  described  in  the  FEMWATER 
mode  (Yeh,  1987). 

The  principles  of  mass  balance  were  employed  to  derive  the  transport  equations  governing  the 
temporal-spatial  distribution  of  chemicals,  suspended  sediment,  and  bed  sediment.  Chemical  kinetics  based 
on  the  collision  theory  was  used  to  present  the  relationship  between  reactant  and  product  species  in  all 
chemical  reactions  and  volatilization.  The  predictor-corrector  numerical  scheme  was  used  to  solve  the 
transport  equations.  In  the  predictor  step,  the  Lagrangian-Eulerian  method  was  employed  to  solve  the 
advection-dispersion  transport  equation  with  the  source/sink  term  evaluated  at  the  previous  time.  In  the 
corrector  step,  the  implicit  finite  difference  was  used  to  solve  the  system  of  ordinary  equations  governing 
the  chemical  kinetic  reactions.  The  nonlinearity  in  flow  and  sediment  transport  equations  is  handled  with 
the  Picard  method,  while  the  nonlinear  chemical  system  is  solved  by  using  the  Newton-Raphson  method. 

In  the  following,  Section  2  provides  a  heuristic  derivation  of  the  governing  equations  for  flow  in 
river/stream  network  (Section  2.1),  surface  runoff  in  the  overland  regime  (Section  2.2),  flow  in  the 
subsurface  (Section  2.3)  sediment  and  chemical  transport  in  river/stream  network  (Section  2.4),  sediment 
and  chemical  transport  in  the  overland  regime  (Section  2.5),  and  chemical  transport  in  the  subsurface 
(Section  2.6).  Section  3  includes  numerical  approaches  to  solve  governing  equations  for  flows  in  the 
river/stream  network,  overland,  and  subsurface  systems.  Dynamic  wave  and  kinematic/diffusion  wave 
models  are  both  given  for  solving  flow  on  ground  surface.  This  section  also  describes  the  numerical 
approximation  to  solve  both  sediment  and  chemical  transport  in  river/stream  network  and  overland  regimes, 
and  chemical  transport  in  the  subsurface  as  well.  Section  4  gives  15  groups  of  example  problems  to  illustrate 
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the  capability  of  the  model.  These  include:  (1)  1-D  flow,  (2)  2-D  flow,  (3)  1-D  transport,  (4)  2-D  transport, 
(5)  1-D  flow  and  transport,  (6)  2-D  flow  and  transport,  (7)  1-D/2-D  flow,  (8)  1-D/2-D  flow  and  transport,  (9) 
3-D  flow,  (10)  3-D  transport,  (1 1)  3D  flow  and  transport,  (12)  2-D/3D  flow,  (13)  2-D/3-D  flow  and  transport, 
(14)  1-D/2-D/3-D  flow,  and  ( 15)  1-D/2-D/3-D  flow  and  transport.  A  summary  and  continuing  work  are  given 
in  Section  5.  A  data  input  guide  is  presented  in  Appendix  I,  program  structure  and  subroutine  are  described 
in  Appendix  D,  and  required  parameters  to  run  the  model  are  listed  in  Appendix  IH. 
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Section  2.  MATHEMATICAL  BASIS 


In  this  section,  we  present  give  governing  equations,  initial  conditions,  and  boundary  conditions  for 
simulating  water  flow  and  chemical  and  sediment  transport  in  watershed  systems. 


2.1.  Water  flow  in  1-D  river/stream 

The  governing  equations  of  water  flow  in  1-D  river/stream  can  be  derived  based  on  the  conservation 
law  of  water  mass  and  linear  momentum  [Singh,  1996],  and  can  be  written  as  follows. 


The  continuity  equation: 

=  ss+sR-sI+s1+s2  (2.i) 

at  ax  s  R  1  1  2 

where  t  is  time  [T];  x  is  the  axis  along  the  river/stream  direction  [L];  A  is  cross-sectional  area  of  the 
river/stream  [L2];  Q  is  flow  rate  of  the  river/stream  [L3/T] ;  Ss  is  the  man-induced  source  [L2/T];  SR  is  the 
source  due  to  rainfall  [L2/T];  S]  is  the  sink  due  to  infiltration  [L2/T];  Sj  and  S2  are  the  source  terms 
contributed  from  overland  flow  [L2/T]. 


The  momentum  equation: 


dQ 

dt 


duQ 

dx 
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where  h  is  water  depth  [L];  u  is  river/stream  velocity  [L/T];  g  is  gravity  [L/T2];  Zq  is  bottom  elevation  [L]; 
Fx  is  the  momentum  flux  due  to  eddy  viscosity  [L4/T2];  ur  is  the  velocity  of  rainfall  along  the  river/stream 
direction  [L/T];  u'  is  the  velocity  of  infiltration  along  the  river/stream  direction  [L/T];  uYI  and  uY2  are  the 
velocity,  along  the  river/stream  direction  [L/T],  of  water  from  overland  to  river/stream;  p  is  water  density 
[M/L3];  Ts  is  surface  shear  stress  [M/T2];  Tb  is  bottom  shear  stress  [M/T2]. 


Eqs.  (2.1)  and  (2.2)  are  the  governing  equations  of  a  1-D  dynamic  wave  river/stream  flow  model. 
When  the  diffusion  wave  model  is  considered,  however,  the  inertia  terms  along  the  momentum  equation  is 
assumed  negligible  when  compared  with  the  other  terms.  By  further  assuming  negligible  surface  shear  stress, 
negligible  eddy  viscosity,  and  ur  =  u1  =  uY1  =  uY2  =  0,  we  approximate  the  river/stream  velocity  with  the 
following  equation  (Hergarten  and  Neugebauer,  1995). 


-1 

R 

1  3(Z0  +  h) 

n 

1+(VZ0)2 

(V(Z0  +h))1/2  dx 

(2.3) 


where  n  is  Manning’s  roughness;  R  is  hydraulic  radius  [L],  which  is  defined  as  R(x,t)  =  R*(x,h(x,t))  =  A/P, 
P  is  the  wetted  perimeter  [L]  and  can  be  expressed  as  P(x,t)  =  P*(x,h(x,t)). 


To  achieve  transient  simulations,  either  water  depth  or  stage  must  be  given  as  the  initial  condition, 
as  well  as  flow  velocity.  In  addition,  appropriate  boundary  conditions  need  to  be  specified  to  match  the 
corresponding  physical  system.  In  the  model,  four  types  of  boundary  conditions  are  taken  into  account  and 
are  stated  as  follows. 
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Water  depth-  or  stage-specified  boundary  condition: 

This  condition  is  applied  when  either  water  depth  or  stage  can  be  prescribed  at  the  river/stream 
boundary  through  the  simulation  time  of  period.  Such  a  condition  can  be  expressed  as 


h(xb,t)  =  hb(t) 

(2.4) 

h(xb,t)  +Zo(xb)  -  Hb(t) 

(2.5) 

where  xb  is  the  coordinate  of  a  river/stream  boundary;  hb(t)  is  a  prescribed  time-dependent  water  depth  [L]; 
Hb(t)  is  a  prescribed  time-dependent  water  stage  [L]. 

Flow  rate-specified  boundary  condition: 

This  condition  is  employed  when  the  time-dependent  incoming  flow  rate  can  be  prescribed  at  a 
upstream  river/stream  boundary.  It  can  be  expressed  as 

Q(xb,t)  =  u(xb,t)A(xb,t)  =  Qb(t)  (2.6) 

where  Qb(t)  is  a  time-dependent  flow  rate  [L3/T]. 

Water  depth-dependent  flow  rate  boundary  condition: 

This  condition  is  often  used  to  describe  the  flow  rate  at  a  downstream  river/stream  boundary  at  which 
the  flow  rate  is  a  function  of  water  depth.  It  can  be  written  as 

Q(xb,t)  =  u(xb,t)A(xb,t)  =  Qb(h(xb,t))  (2.7) 

where  Qb(h(xb,t))  is  a  water  depth-dependent  flow  rate  [L3/T]. 

Junction  boundary  condition: 

This  condition  is  applied  to  a  boundary  of  a  river/stream  reach  when  the  boundary  is  connected  to 
a  junction.  In  this  case,  the  stage  of  the  boundary  is  specified  as  the  stage  of  the  junction.  That  is, 

h(xb>t) +Z0(xb)  =  Hjunction  (t)  (2.8) 

HjunctionO)  is  the  water  stage  [L]  at  the  junction  that  is  computed  through  the  computation  of  water  budget. 
We  will  give  the  detail  of  computing  Hjunction(t)  in  Section  3. 


2.2.  Water  flow  in  2-D  overland 

The  governing  equations  of  2-D  overland  flow  can  be  derived  based  on  the  conservation  law  of  water 
mass  and  linear  momentum  [Wang  and  Connor,  1975].  The  governing  equations  of  a  dynamic  wave  model 
can  be  written  as  follows. 

The  continuity  equation: 
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=  SS+R-I 


(2.9) 


dh  duh  +  dvh 
dt  dx  dy 

where  h  is  water  depth  [L] ;  u  is  the  x- velocity  [L/T] ;  v  is  the  y-velocity  [L/T] ;  SS  is  the  man-induced  source 
[L/T];  R  is  the  source  due  to  rainfall  [L/T];  I  is  the  sink  due  to  infiltration  [L/T]. 


The  x-momentum  equation: 


duh  |  du2h  +  duvh 
dt  dx  dy 


-gh 


dx  dx  dy 
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where  Zq  is  the  bottom  elevation  of  overland  [L] ;  ur  is  the  component  of  rainfall  velocity  along  the  x-direction 
[L/T];  u1  is  the  component  of  infiltration  velocity  along  the  x-direction  [L/T];  Fxx  and  are  the  fluxes  due 
to  eddy  viscosity  along  the  x-direction  [L3/T2] ;  Txs  is  the  component  of  surface  shear  stress  along  the  x- 
direction  over  unit  horizontal  overland  area  [M/L/T2];  Txb  is  the  component  of  bottom  shear  stress  along  the 
x-direction  over  unit  horizontal  overland  area  [M/L/T2]. 


The  v-momentum  equation: 

dvh  ,  duvh  +  dv2h  =  _  h^V^+^+^+(vrR-viI)+^L^  (2.11) 

dt  dx  dy  dy  dx  dy  p 

where  v1  is  the  component  of  rainfall  velocity  along  the  y-direction  [L/T];  v*  is  the  component  of  infiltration 
velocity  along  the  y-direction  [L/T] ;  Fxy  and  Fyy  are  the  fluxes  due  to  eddy  viscosity  along  the  y-direction 
[L3/T2];  Tysis  the  component  of  surface  shear  stress  along  the  y-direction  over  unit  horizontal  overland  area 
[M/L/T2];  Tyb  is  the  component  of  bottom  shear  stress  along  the  y-direction  over  unit  horizontal  overland  area 
[M/L/T2]. 

In  Eqs.  (2.10)  and  (2.1 1),  it  is  noted  that  if  R  >  0,  ur  and  vr  are  prescribed;  otherwise,  ur  =  u  and  v1 
=  v.  Likewise,  if  I  <  0,  u*  and  vj  are  either  prescribed  or  computed  with  subsurface  flow  models;  otherwise, 
u‘  =  u  and  v1  =  v. 


When  the  diffusion  wave  model  is  considered,  the  inertia  terms  in  Eqs.  (2. 10)  and  (2. 1 1)  are  assumed 
not  important  when  compared  to  the  others.  With  the  further  assumption  that  eddy  viscosity  is  insignificant, 
surface  shear  stress  is  negligible,  and  ur  =  V  =  u1  =  v1  =  0,  we  approximate  the  velocity  (u,  v)  as  follows. 
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To  perform  transient  simulations,  water  depth  (or  stage)  and  velocity  must  be  given  as  the  initial 
conditions.  Four  types  of  boundary  conditions  are  implemented  in  the  model,  as  described  as  follows. 


Water  depth-  or  stage-specified  boundary  condition: 
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This  condition  is  applied  when  either  water  depth  or  stage  can  be  prescribed  at  overland  boundary 
nodes  through  the  simulation  time  of  period.  Such  a  condition  can  be  expressed  as 

h(xb,yb,t)  =  hb(t)  (2.14) 

or 

h(xb,yb,t)+Z0(xb,yb)  =  Hb(t)  (2.15) 

where  (xb,  yb)  is  the  coordinate  of  a  overland  boundary  node;  hb(t)  is  a  prescribed  time-dependent  water  depth 
[L];  Hb(t)  is  a  prescribed  time-dependent  water  stage  [L]. 

Normal  flux-specified  boundary  condition: 

This  condition  is  employed  when  the  time-dependent  incoming  normal  flux  can  be  prescribed  at  a 
upstream  overland  boundary  segment.  It  can  be  expressed  as 

-n*q(xb,yb,t)  =  -n-V(xb,yb,t)  h(xb,yb,t)  =  qb(t)  (2.16) 

where  n  is  the  outward  unit  normal  vector  of  the  boundary  segment;  V  =  (u,  v);  qb(t)  is  a  time-dependent 
normal  flux  [L2/T]. 

Water  depth-dependent  normal  flux  boundary  condition: 

This  condition  is  often  used  to  describe  the  outgoing  normal  flux  at  a  downstream  overland  boundary 
segment  at  which  the  flux  is  a  function  of  water  depth.  It  can  be  written  as 

-n-q(xb,yb,t)  =  -n-V(xb,yb,t)  h(xb,yb,t)  =  ~qb(h(xb,yb,t))  (2.17) 

where  qb(h(xb,yb,t))  is  a  water  depth-dependent  normal  flux  [L2/T]. 

River/stream-  or  junction-related  boundary  condition: 

This  condition  is  applied  to  a  overland  boundary  segment  when  the  boundary  segment  is  next  to  a 
river/stream  or  a  junction,  and  through  the  segment  water  may  flow  from  overland  to  river/stream  or  from 
river/stream  to  overland,  depending  on  the  water  stages  at  both  river/stream  and  overland.  In  this  occasion, 
the  normal  flux  is  computed  based  on  either  the  water  depth  on  the  overland  boundary  or  the  difference 
between  overland  and  river/stream  water  stages.  Three  cases  are  included  in  this  type  of  boundary  condition. 

<  Case  1  >  River/stream  water  stage  is  lower  than  the  bottom  elevation  of  the  overland  boundary. 

In  this  case,  water  is  injected  to  river/stream  from  overland.  The  normal  flux  can  be  expressed  as 

-n-q(xb,yb,t)  =  -n*V(xb,yb,t)  h(xb,yb,t)  =  -  qb(h(xb,yb,t))  (2.18) 

where  qb(h(xb,yb,t))  is  a  water  depth-dependent  normal  flux  [L2/T]. 

<  Case  2  >  River/stream  water  stage  is  higher  than  the  bottom  elevation  of  the  overland  boundary  but  is  lower 
than  the  water  stage  of  the  overland  boundary. 

In  this  case,  water  is  still  injected  to  river/stream  from  overland.  The  normal  flux  can  be  expressed 
as 
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(2.19) 


-n*q(xb,yb,t)  =  -n-V(xb,yb,t)  h(xb,yb,t)  =  -qb(AH(xb,yb,t)) 

AH(xb,yb,t)  =  H(xb,yb,t)-Hc(xc,t)  (2.20) 

where  H(xb,yb,t)  is  the  water  stage  on  the  overland  boundary  [L] ;  Hc(xc,t)  is  the  water  stage  at  the  river/stream 
related  to  the  overland  boundary  [L];  AH  is  the  stage  difference  between  river/stream  and  overland  [L]; 
qb(AH(xb,yb,t))  is  a  stage  difference-dependent  normal  flux  [L2/T]. 

<  Case  3  >  River/stream  water  stage  is  higher  than  the  water  stage  of  the  overland  boundary. 

In  this  case,  water  flows  from  river/stream  to  overland.  The  normal  flux  can  be  expressed  as 

-n*q(xb,yb,t)  =  -n-V(xb,yb,t)h(xb,yb,t)  =  qb(AH(xb,yb,t))  (2.21) 

AH(xb,yb,t)  =  Hc(xc,t)-H(xb,yb,t)  (2.22) 

where  qb(AH(xb,yb,t))  is  a  stage  difference-dependent  normal  flux  [L2/T]. 


2.3.  Water  flow  in  3-D  subsurface 


The  governing  equation  of  subsurface  flow  through  saturated-unsaturated  porous  media  can  be 
derived  based  on  the  conservation  law  of  water  mass  [Yeh,  1987].  It  is  written  as  follows. 

— +V-V  =  F—  +V-[  -K’(Vh+Vz)]  =  q  (2.23) 

at  at 


where  h  is  the  pressure  head  [L];  t  is  time  [T];  K  is  the  hydraulic  conductivity  tensor  [L/T] ;  z  is  the  potential 
head  [L];  q  is  the  source  and/or  sink  [L3/L3];  and  F  is  the  water  capacity  [L3/L3/T]  given  by 


F 


d0 

dh 


(2.24) 


in  which  0  is  the  moisture  content  [L3/L3]. 


To  achieve  transient  simulation,  the  following  initial  condition  needs  to  be  given. 

h  =  hj(x,y,z)  in  R,  (2.25) 

where  R  is  the  region  of  interest  and  hj  is  the  prescribed  pressure  head  [L],  which  can  be  obtained  by  either 
field  measurements  or  by  solving  the  steady  state  version  of  Eq.  (2.23). 

Five  types  of  boundary  conditions  are  taken  into  account  as  follows. 


Dirichlet  conditions: 

This  boundary  condition  is  used  when  pressure  head  can  be  prescribed  on  the  boundary.  It  can  be 
expressed  as 

h  =  hd(xb,yb,zb,t)  on  Bd  (2.26) 


Neumann  conditions: 
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This  boundary  condition  is  employed  when  the  flux  results  from  pressure-head  gradient  is  known 
as  a  function  of  time.  It  is  written  as 

-n-K-Vh  =  qn(xb,yb,zb,t)  on  Bn,  (2.27) 

Cauchv  conditions: 

This  boundary  condition  is  employed  when  the  flux  results  from  total-head  gradient  is  known  as  a 
function  of  time.  It  can  be  written  as 

-n-(K*Vh+K*Vz)  =  qc(xb,yb,zb,t)  on  Bc,  (2.28) 

River  Boundary  Conditions: 

K 

-irK*(Vh  +  Vz)  =  — — (hR— h)  on  Br  (2.29) 

bR 


Variable  conditions: 

This  boundary  condition  is  usually  used  for  the  ground  surface  boundary  when  the  coupling  of 
surface  and  subsurface  systenis  is  not  taken  into  account. 


(1)  During  precipitation  periods: 


h  =  Vvyb’M) 

on 

Bv 

(2.30) 

or 

-n-K-(Vh+Vz)  =  qp(xb,yb. 

zb»0 

on  Bv, 

(2.31) 

(2)  During  non-precipitation  periods 

h  = 

on 

Bv, 

(2.32) 

or 

h  = 

on 

Bv» 

(2.33) 

or 

-n-K*(Vh+Vz)  =  qe(xb,yb, 

M) 

on  Bv, 

(2.34) 

Surface/Subsurface  interface  variable  conditions: 


This  boundary  condition  is  usually  used  for  the  ground  surface  boundary  (i.e.,  the  interface  of  surface 
and  subsurface  systems)  when  the  coupling  of  surface  and  subsurface  systems  is  taken  into  consideration. 

(1)  During  precipitation  periods: 

h  =  h2(xb,yb,zb,t)  on  Biv 


(2.35) 


h2(x.,yb,zb,t) 

-n-K-(Vh+Vz)  =  qp(xb,yb,zb,t)  +  °  — 


on  Biv,  (2.36) 


(2)  During  non-precipitation  periods 

h  =  h2(xb,yb,zb,t)  on  Biv,  (2.37) 

or 

h  =  on  B.v  (2-38) 

or 

-n*K-(Vh+Vz)  =  qe(xb,yb,zb,t)  on  Biv,  (2.39) 

where  (xb,yb,zb)  is  the  spatial  coordinate  on  the  boundary;  n  is  an  outward  unit  vector  normal  to  the  boundary; 
hd,  (jj,,  and  qc  are  the  prescribed  Dirichlet  functional  value  [L],  Neumann  flux  [L3/L2/T],  and  Cauchy  flux 
[L3/L2/T],  respectively;  Bd,  Bn,  and  Bc  are  the  Dirichlet,  Neumann,  and  Cauchy  boundary,  respectively;  Bv 
is  the  variable  boundary  and  Biv  is  the  surface/subsurface  interface  variable  boundary;  hp  is  the  allowed 
ponding  depth  [L]  and  qp  is  the  throughfall  of  precipitation  [L/T],  respectively,  on  the  variable  boundary; 
hm  is  the  allowed  minimum  pressure  head  [L]  on  the  variable  boundary;  h2  is  water  depth  [L]  at  surface;  qe 
is  the  allowed  maximum  evaporation  rate  [L3/L2/T]  on  the  variable  boundary,  which  is  the  potential 
evaporation;  At  is  time  step  size  [T];  KR  is  the  hydraulic  conductivity  of  the  river  bottom  sediment  layer 
[L/T],  bR  is  the  thickness  of  the  river  bottom  sediment  layer  [L],  hR  is  the  depth  of  the  river  bottom  measured 
from  the  river  surface  to  the  top  of  the  bottom  sediment  layer  [L],  and  Br  is  the  river  boundary  segment. 
Only  one  of  Eqs.  (2.30)  through  (2.34)  is  used  at  any  point  on  the  variable  boundary  at  any  time.  It  should 
be  noted  that  when  both  surface  and  subsurface  flows  are  simulated,  the  allowed  ponding  depth  (hp)  is  the 
actual  water  depth  computed  in  the  surface  models  (i.e.,  h2  in  Eqs.  (2.35)  through  (2.37))  and  the  maximum 
infiltration  is  equal  to  the  sum  of  throughfall  of  precipitation  (qp)  and  the  average  consumption  rate  of  surface 
water  depth  during  a  time  step. 


2.4.  Chemical  and  sediment  transport  in  1-D  river/stream 

The  transport  governing  equations  of  both  chemicals  and  sediments  in  1-D  river/stream  system  can 
be  derived  based  on  the  conservation  law  of  material  mass  [Yeh,  1983].  They  can  be  written  as  follows. 


Continuity  equation  for  suspended  sediments: 


a(Asn)  t  d(Qsn)  e 

dt  dx  5x 


KA- 


dx 


Mns  +Mn0S  +(Rn  -Dn)P 


ne[l,NJ 


Continuity  equation  for  bed  sediments: 


at 


=  D  -R 

n  n 


ne[l,Ns] 


Continuity  equation  for  dissolved  chemicals: 


(2.40) 


(2.41) 
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acAO  a(QCiw)  a 


at 


ac=" 

a _ L 

5x  axl  x  dx 


-  M,“  -A'AC  *  -  Ak*(p,  -i^C  iVE  S.AfCj  -4c *)  ♦M,”’  -M*  (2.42) 

kab  n-1  k 

ni 


tEk“M„P(C„b->;C')  +  E  (^-WA 


n=l 


,  bb 
Kni 


m=l 


C  krf 
xb"  Km 


n  (qT'-^n  <qw) 


Continuity  equation  for  particulate  chemicals  on  suspended  sediments: 


d(ASnC£  d(QSnC£)  d 


dt 


dx 


dx[  dx 


ie[l,Nl 


M^s  -  A>SnC^  -tf  S.A^  --^O  +RnBCmb  -DnBC^  +Mm 


(2.43) 


,  sb 
Kni 


ne[l,Ns],  ie[l,Nc] 

Continuity  equation  for  particulate  chemicals  on  bed  sediments: 


-  (D„Cj-R„C.b)-A‘M„C„b-k„bbM„ 

ot 


kbf 

n  b  ni  n  w 
'"■"ni 

k„bb 


ne[l,N  l,ie[l,N  ]  (2.44) 


where 

A 

B 

bmjC 


Cw 

C" 

c? 

CJ 


c  s 


D„ 

I 

K, 

k* 

K5 


River/stream  cross-sectional  area  [L2]; 

Stoichiometric  coefficient  of  the  j-th  dissolved  chemical  in  the  m-th  aqueous  complexation 
reaction  when  this  dissolved  chemical  appears  as  a  reactant  chemical; 

Top  river/stream  width  [L]; 

Stoichiometric  coefficient  of  the  j-th  dissolved  chemical  in  the  m-th  aqueous  complexation 
reaction  when  this  dissolved  chemical  appears  as  a  product  chemical; 
Cross-sectionally-averaged  concentration  of  the  i-th  dissolved  chemical  [M/L3]; 
Concentration  of  the  i-th  dissolved  chemical  in  rainfall  [M/L3] ; 

Concentration  of  the  i-th  dissolved  chemical  in  the  subsurface  [M/L3]; 
Cross-sectionally-averaged  particulate  chemical  concentration  on  bed  sediment  of  the  n-th 
fraction  size  [M/M]; 

Cross-sectionally-averaged  particulate  chemical  concentration  on  suspended  sediment  of  the 
n-th  fraction  size  [M/M]; 

Deposition  rate  of  the  n-th  size  fraction  sediment  [M/L2/T]; 

Infiltration  from  river/stream  to  subsurface  [L2/T]; 

Longitudinal  dispersion  coefficient  [L2/T]; 

Backward  volatilization  rate  constant  associated  with  the  i-th  dissolved  chemical  in  the 
atmosphere  [M/atm/L3/T]; 

Forward  volatilization  rate  constant  associated  with  the  i-th  dissolved  chemical  in  the 
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K?  = 
k/  = 

K*  = 
K?  = 
KJ*  = 

Kib{  = 

Mn  = 
M„s  = 
Mnos  = 


Mni"  = 
= 


MjCW  = 

M™  = 

Miciw  = 


M,cow  = 


Nc  = 

Nra  = 

Ns 

P 

Pi 

Q 

R 

Rn 

Ri,  R2  = 


sn  — 


X 


atmosphere  [1/T]; 

Backward  adsorption  rate  constant  associated  with  the  i-th  particulate  chemical  on 
suspended  sediment  of  the  n-th  fraction  size  [1/T]; 

Forward  adsorption  rate  constant  associated  with  the  i-th  particulate  chemical  on  suspended 
sediment  of  the  n-th  fraction  size  [L3/M/T]; 

Backward  rate  constant  of  the  m-th  aqueous  complexation  reaction  [reaction-dependent]  ; 
Forward  rate  constant  of  the  m-th  aqueous  complexation  reaction  [reaction-dependent]; 
Backward  adsorption  rate  constant  associated  with  the  i-th  particulate  chemical  on 
suspended  sediment  of  the  n-th  fraction  size  [1/T]; 

Forward  adsorption  rate  constant  associated  with  the  i-th  particulate  chemical  on  bed 
sediment  of  the  n-th  fraction  size  [L3/M/T]; 

Sediment  mass  per  unit  bed  area  of  the  n-th  size  fraction  [M/L2]; 

Source  of  the  n-th  size  fraction  sediment  [M/L/T]; 

Source  of  the  n-th  size  fraction  sediment  from  overland  [M/L/T]; 

It  is  equal  to  R,Sn0Sl+R2Sn0s2,  where  S„osl  and  Snos2  are  the  associated  suspended  sediment 
concentration  of  the  n-th  size  fraction  from  overland. 

Source  of  the  i-th  particulate  chemical  on  suspended  sediment  of  the  n-th  fraction  size 
[M/L/T]; 

Source  of  the  i-th  particulate  chemical  on  suspended  sediment  of  the  n-th  fraction  size  from 
overland  [M/L/T]; 

It  is  equal  to  R1SnoslCniosl+R2Snos2CIlios2,  where  C^081  and  CJ*2  are  the  associated  i-th 
particulate  chemical  concentration  on  suspended  sediment  of  the  n-th  size  fraction  from 
overland. 

Source  of  the  i-th  dissolved  chemical  [M/L/T]; 

Rainfall  source  of  the  i-th  dissolved  chemical  [M/L/T]; 

It  is  equal  to  RC™  if  R  is  positive.  Otherwise,  it  is  zero. 

Infiltration  sink  of  the  i-th  dissolved  chemical  [M/L/T]; 

It  is  equatl  to  IC"  if  I  is  positive.  Otherwise,  it  is  ICisw  representing  a  source  from  the 
subsurface. 

Source  of  the  i-th  dissolved  chemical  from  overland  [M/L/T];  it  is  equal  to  R,Ciowl+R2Ciow2, 
where  Q0*1  and  C°w2  are  the  associated  i-th  dissolved  chemical  concentrations  from 
overland. 

Number  of  dissolved  chemicals; 

Number  of  aqueous  complexation  reactions; 

Number  of  sizes  of  sediments; 

Wetted  perimeter  [L]; 

Partial  pressure  of  the  i-th  dissolved  chemical  in  the  atmosphere  [atm]; 

River/stream  flow  rate  [L3/T] ; 

Rainfall  to  river/stream  [L2/T]; 

Erosion  rate  of  the  n-th  size  fraction  sediment  [M/L2/T]; 

Surface  runoff  from  overland  to  river/stream  [L2/T];  the  subscripts  1  and  2  are  used  to 
differentiate  the  flows  through  the  two  river/stream-overland  interfaces  because  they  usually 
are  not  the  same  in  practice. 

Cross-sectionally-averaged  sediment  concentration  of  the  n-th  fraction  size  [M/L3]; 

Time  [T]; 

River/stream  coordinate  [L]; 

Combined  first  order  degradation  rate  constant  of  the  i-th  dissolved  chemical  [1/T]; 
Combined  first  order  degradation  rate  constant  of  the  i-th  particulate  chemical  on  bed 
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sediment  of  the  n-th  fraction  size  [1/T]; 

Combined  first  order  degradation  rate  constant  of  the  i-th  particulate  chemical  on  suspended 
sediment  of  the  n-th  fraction  size  [1/T]; 


XJ 


In  obtaining  Eqs.  (2.42)  through  (2.44),  the  following  reactions  are  considered. 

(1)  Aqueous  complexation  reactions:  kmrb  and  kmrf  as  backward  and  forward  reaction  rate  constants. 

E  «£C*  -  E  m e [  1  .Nm]  (2.45) 


j  =  l 


r  =  ^n<c1w),-i  -cn<c;)b- 

j*i  j=1 

where  R  is  defined  as  the  reaction  rate  of  the  aqueous  complexation  reaction. 


(2.46) 


(2)  Adsorption/desorption  between  the  dissolved  phase  and  suspended  sediment:  k,/b  and  k,/  as  backward 
and  forward  reaction  rate  constants. 


CJ+S,  ie[l,Nc],ne[l,Ns] 

(2.47) 

-  I4fsnc,w  -  k*snc* 

(2.48) 

where  R  is  defined  as  the  reaction  rate  of  the  adsorption  reaction. 

(3)  Adsorption/desorption  between  the  dissolved  phase  and  bed  sediment:  knibb  and  as  backward  and 
forward  reaction  rate  constants. 


Ciw+Mn  -  +Mn 

ie[l,Nc],ne[l,NJ 

(2.49) 

R  =  kXc" 

-  CMnCmb 

(2.50) 

where  R  is  defined  as  the  reaction  rate  of  the  adsorption  reaction. 

(4)  Volatilization  between  the  dissolved  phase  and  atmosphere:  kjab  and  as  backward  and  forward  reaction 
rate  constants. 

C*  *  Pi 

ie[l,Nc] 

(2.51) 

R  =  k^C* 

,  ab 

-  ki  Pi 

(2.52) 

where  R  is  defined  as  the  reaction  rate  of  the  volatilization  reaction.  In  Eqs.  (2.45),  (2.47),  (2.49),  and  (2.5 1), 
the  overline  is  used  to  present  the  formula,  rather  than  the  concentration,  of  a  chemical  or  a  sediment. 


The  concentrations  of  all  chemical  species  and  sediments  must  be  given  initially  for  transient 
simulations.  In  the  model,  both  bed  sediments  and  particulate  chemicals  sorbed  on  the  bed  sediments  are 
considered  to  be  immobile,  as  described  by  Eqs.  (2.41)  and  (2.44).  Therefore,  boundary  conditions  are 
needed  for  suspended  sediments,  dissolved  chemicals,  and  particulate  chemicals  on  suspended  sediments. 
Four  types  of  boundary  conditions  are  taken  into  account  as  stated  as  follows. 
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Dirichlet  boundary  condition: 


This  conditions  is  applied  when  concentration  is  given  at  the  boundary.  That  is, 

C(xb,t)  =  Cb(t)  (2.53) 

where  C  can  be  the  S„,  C*,  or  SnC,/;  Cb(t)  is  a  time-dependent  concentration  [M/L3]. 


Variable  boundary  condition: 

This  boundary  condition  is  employed  when  the  flow  direction  would  change  with  time  during 
simulations.  Two  cases  are  considered,  regarding  to  the  flow  direction  on  the  boundary. 

<  Case  1  >  Flow  is  coming  in  from  outside: 

6C(x,,t) 

QC(xb,t)-AKx— S- 
dx 

<  Case  2  >  Flow  is  going  out  from  inside: 

ac(xh,t) 

-AK  b  =0  on  Bv  (2.55) 

dx 

where  Cb(t)  is  a  time-dependent  concentration  [M/L3]  which  is  associated  with  the  incoming  flow. 


QCh(t) 


(2.54) 


Cauchy  boundary  condition: 


This  boundary  condition  is  employed  when  the  total  material  flow  rate  is  given  at  the  river/stream 
boundary.  Usually,  this  boundary  is  a  upstream  boundary  node.  The  conditions  can  be  expressed  as 


n 


QC(x„,t)-AKx 


dC(xb,t) 

dx 


=  Qbc(0 


(2.56) 


where  Qbc(t)  is  material  flow  rate  [M/T];  n  =  1  if  the  boundary  is  a  upstream  boundary  node,  or  n  =  -1  if  it 
is  a  downstream  boundary  node. 


Neumann  boundary  condition: 


This  boundary  condition  is  used  when  the  diffusive  material  flow  rate  is  known  at  the  river/stream 
boundary  node.  It  can  be  written  as 


-nAKx 

where  Qbc(t)  is  material  flow  rate  [M/T]. 


dC(xb,t) 

dx 


=  Qbc(t) 


(2.57) 


2.5.  Chemical  and  sediment  transport  in  2-D  overland 

The  equations  governing  chemical  and  sediment  transport  in  2-D  overland  can  be  derived  according 
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to  the  conservation  law  of  material  mass.  They  can  be  written  as  follows. 


Continuity  equation  for  suspended  sediments 

3(hSn) 


at 


+V-(qSn)  =  V-[hK-VSn]  +  Mns+(Rn-Dn)  ne[l,Ns] 


Continuity  equation  for  bed  sediments: 

sm 

It 


-  =  D  -Rn 

n  n 


ne[l,Nl 


Continuity  equation  for  dissolved  chemicals: 
d(hC;w) 


at 

=  V' 


+V'(qCj  ) 


h  K*VCjW  ] + Mj0*  -  X'  h  CjW  +hkiab(pi-^Ciw)  +£  k*bSnh(C^ 


Ns 

I 

n=l 


k“ 


c 


m  =  l 


n  (cd* 


kiu  -  , 

m  3=1 


+  MjCrw  -MjCiw  ie[l,Nc] 

Continuity  equation  for  particulate  chemical  on  suspended  sediments: 

d(hSnO 


at 

=  V' 


+V-(qSnO 


.  ksf 

hK-V(SnO  +M1^hSnC^bSnh(C^Ciw) 

kn, 


(2.58) 


(2.59) 


(2.60) 


(2.61) 


+  RnCm°-DnC^ 


ne[l,Ns],  ie[l,Nc] 
Continuity  equation  for  particulate  chemical  on  bed  sediments: 


at 


k_bf 

cb-^« 

m  .  bb 

k„; 


ne[l,N  l,ie[l,Nc]  (2.62) 


where 

h 

a*/ 


bmjc 


Cw 


Water  depth  [L]; 

Stoichiometric  coefficient  of  the  j-th  dissolved  chemical  in  the  m-th  aqueous  complexation 
reaction  when  this  dissolved  chemical  appears  as  a  reactant  chemical; 

Stoichiometric  coefficient  of  the  j-th  dissolved  chemical  in  the  m-th  aqueous  complexation 
reaction  when  this  dissolved  chemical  appears  as  a  product  chemical; 

Depth-averaged  concentration  of  the  i-th  dissolved  chemical  [M/L3]; 
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cj 

Dn 

I 

K 
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kni‘b 

k/ 

K? 


Cf 

Mn 
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Mnj" 

Micw 

M'iw 


Nc 

Ns 

Pi 
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Concentration  of  the  i-th  dissolved  chemical  in  rainfall  [M/L3]; 

Concentration  of  the  i-th  dissolved  chemical  in  the  subsurface  [M/L3]; 

Depth-averaged  particulate  chemical  concentration  on  bed  sediment  of  the  n-th  fraction  size 
[MM]; 

Depth-averaged  particulate  chemical  concentration  on  suspended  sediment  of  the  n-th 
fraction  size  [MM]; 

Deposition  rate  of  the  n-th  size  fraction  sediment  [M/L2/T]; 

Infiltration  from  overland  to  subsurface  [L/T]; 

Dispersion  coefficient  tensor  [L2/T]; 

Backward  volatilization  rate  constant  associated  with  the  i-th  dissolved  chemical  in  the 
atmosphere  [M/atm/L3/T]; 

Forward  volatilization  rate  constant  associated  with  the  i-th  dissolved  chemical  in  the 
atmosphere  [1/T]; 

Backward  adsorption  rate  constant  associated  with  the  i-th  particulate  chemical  on 
suspended  sediment  of  the  n-th  fraction  size  [1/T]; 

Forward  adsorption  rate  constant  associated  with  the  i-th  particulate  chemical  on  suspended 
sediment  of  the  n-th  fraction  size  [L3/M/T]; 

Backward  rate  constant  of  the  m-th  aqueous  complexation  reaction  [reaction-dependent]; 
Forward  rate  constant  of  the  m-th  aqueous  complexation  reaction  [reaction-dependent]; 
Backward  adsorption  rate  constant  associated  with  the  i-th  particulate  chemical  on 
suspended  sediment  of  the  n-th  fraction  size  [1/T]; 

Forward  adsorption  rate  constant  associated  with  the  i-th  particulate  chemical  on  bed 
sediment  of  the  n-th  fraction  size  [L3/M/T]; 

Sediment  mass  per  unit  bed  area  of  the  n-th  size  fraction  [M/L2]; 

Source  of  the  n-th  size  fraction  sediment  [M/L2/T]; 

Source  of  the  i-th  particulate  chemical  on  suspended  sediment  of  the  n-th  fraction  size 
[M/L2/T]; 

Source  of  the  i-th  dissolved  chemical  [M/L2/T]; 

Rainfall  source  of  the  i-th  dissolved  chemical  [M/L2/T]; 

It  is  equal  to  rC™  if  r  is  positive.  Otherwise,  it  is  zero. 

Infiltration  sink  of  the  i-th  dissolved  chemical  [M/L2/T]; 

It  is  equal  to  iC*  if  i  is  positive.  Otherwise,  it  is  iCjsw  representing  a  source  from  the 
subsurface. 

Number  of  dissolved  chemicals; 

Number  of  sizes  of  sediments; 

Gaseous  pressure  in  the  atmosphere  associated  with  the  i-th  dissolved  chemical  [atm]; 
Flux  of  overland  flow  [L2/T]; 

Rainfall  to  overland  [L/T]; 

Erosion  rate  of  the  n-th  size  fraction  sediment  [M/L2/T]; 

Depth-averaged  sediment  concentration  of  the  n-th  fraction  size  [M/L3]; 

External  source/sink  [L/t] ; 

Time  [T]; 

Horizontal  coordinates  [L]; 

Combined  first  order  degradation  rate  constant  of  the  i-th  dissolved  chemical  [1/T]; 
Combined  first  order  degradation  rate  constant  of  the  i-th  particulate  chemical  on  bed 
sediment  of  the  n-th  fraction  size  [1/T]; 

Combined  first  order  degradation  rate  constant  of  the  i-th  particulate  chemical  on  suspended 
sediment  of  the  n-th  fraction  size  [1/T]; 
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In  obtaining  the  above  equations,  the  reactions  described  with  Eqs.  (2.45)  through  (2.52)  are 
considered.  To  achieve  transient  simulations,  the  concentrations  of  chemicals  and  sediments  must  be 
provided  initially.  Four  types  of  boundary  conditions  can  be  used  for  mobile  materials,  i.e.,  suspended 
sediments,  dissolved  chemicals,  and  particulate  chemicals  on  suspended  sediments.  These  four  boundary 
conditions  are 

Dirichlet  boundary  condition: 

This  conditions  is  applied  when  concentration  is  given  at  the  boundary.  That  is, 

C(xb,yb,t)  =  Cb(t)  (2.63) 

where  C  can  be  the  Sn,  Qw,  or  SnCms;  Cb(t)  is  a  time-dependent  concentration  [M/L3]. 

Variable  boundary  condition: 

This  boundary  condition  is  employed  when  the  flow  direction  would  change  with  time  during 
simulations.  Two  cases  are  considered,  regarding  to  the  flow  direction  on  the  overland  boundary  segment. 

<  Case  1  >  Flow  is  coming  in  from  outside: 

-n-[qC(xb,yb,t)-hK-VC(xb,yb,t)]  =  -n-qCb(t)  (2.64) 

<  Case  2  >  Flow  is  going  out  from  inside: 

n  •  ( -  h  K  •  V  C(xb,yb,t) )  =  0  (2.65) 

where  n  is  the  outward  unit  normal  vector  of  the  boundary  segment;  Cb(t)  is  a  time-dependent  concentration 
[M/L3],  which  is  associated  with  the  incoming  flow.  If  both  1-D  river  transport  and  2-D  overland  transport 
are  taken  into  account,  the  1-D/2-D  interface  boundary  is  considered  to  be  a  variable  boundary.  In  this  case, 
Eqs.  (2.64)  and  (2.65)  are  still  valid  but  Cb(t)  in  Eq.  (2.64)  is  the  concentration  of  the  mobile  material  being 
considered  at  1-D  node  corresponding  to  the  interface  boundary. 

Cauchv  boundary  condition: 

This  condition  is  applied  when  the  total  incoming  material  flux  is  prescribed  as  a  function  of  time 
on  an  overland  boundary  segment.  It  can  be  written  as 

-n*[qC(xb,yb,t)  -hK*VC(xb,yb,t)]  =  qbc(t)  (2.66) 

where  qbc(t)  is  a  time-dependent  Cauchy  flux  [M/T/L] 

Neumann  boundary  condition: 

This  conditions  is  employed  when  the  incoming  diffusive  material  flux  can  be  prescribed  on  a 
boundary  segment.  It  is  written  as 

-  n  •  ( -  h  K  •  V  C(xb,y  b,t) )  =  qb(t)  (2.67) 

where  qbc(t)  is  a  time-dependent  Neumann  flux  [M/T/L]. 
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2.6.  Chemical  transport  in  3-D  subsurface 

The  governing  equation  of  chemical  transport  in  the  subsurface  can  be  derived  based  on  the 
conservation  law  of  chemical  mass.  Three  types  of  chemicals  are  considered  in  the  model,  namely,  dissolved 
chemicals,  adsorbing  sites,  and  adsorbed  chemicals.  A  dissolved  chemical  is  a  chemical  species  existing  in 
the  aqueous  phase.  An  adsorbing  site  is  a  chemical  associated  with  the  solid  phase.  Dissolved  chemicals 
can  interact  with  one  another  through  aqueous  complexation.  They  may  also  react  with  adsorbing  sites  to 
form  adsorbed  chemicals  through  adsorption.  Both  adsorbing  sites  and  adsorbed  chemicals  are  considered 
to  be  immobile.  The  continuity  equations  for  the  three  types  of  chemicals  can  be  written  as  follows. 


(1)  For  dissolved  chemicals: 

3(6C:W) 

— - +V*(VC:W)  -V*(0D*VC) 

at  J  j 


-  qc”  -  x'ec;  -  E  (amj-bmj)0 


m=l 


k^ri  (Cjw)a™j  -  cri<Cjw)b”j 

j=i  j=i 


(2.68) 


Eui-H)® 


m=l 

(2)  For  adsorbing  sites: 

g(6Sj) 


,Nc  «  N‘  *  K^r  h 

cn  (chiles/-  -  cbn  (Cjw)  min  (Dj) 

j=i  j=i  j=i  j=i 


j  e  [  1  ,N  ] 


at 


~TXS 

^es,  -  E  <8 


m=l 


cfri  (Cjw)a-  fi  (Sj)a-  -  c  fi  (Cjw)b”j  fi  (Dj)1 

j=i  j=i  j=i  j=i 


(2.69) 


je[l,N  ] 


(3)  For  adsorbed  chemical: 


a(0Dp 

at 


rxs 

-  -  x'eDj .  E  b> 


m  =  l 


cn  (Cj^n  (sp^  -  icbn(c;>b-n  (Dj)b“j 

j=i  j=i  j=i  j=i 


(2.70) 


je[l,Nd] 


where 


D 

K? 


Stoichiometric  coefficient  of  the  j-th  dissolved  chemical  in  the  m-th  aqueous  complexation 
reaction  when  this  dissolved  chemical  appears  as  a  reactant  chemical; 

Stoichiometric  coefficient  of  the  j-th  dissolved  chemical  in  the  m-th  aqueous  complexation 
reaction  when  this  dissolved  chemical  appears  as  a  product  chemical; 

Concentration  of  the  i-th  dissolved  chemical  [M/L3  solution]; 

Concentration  of  the  i-th  dissolved  chemical  in  the  source  [M/L3]; 

Concentration  of  the  i-th  adsorbed  chemical  [M/L3  solution]; 

Dispersion  coefficient  tensor  [L2/T]; 

Backward  rate  constant  of  the  m-th  adsorption  reaction  [reaction-dependent]; 
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K? 

k»* 

K? 

Nc 

Nd 

Ns 


q 

Si 

t 

e 

V 

V 

V 


=  Forward  rate  constant  of  the  m-th  adsorption  reaction  [reaction-dependent]; 
a  Backward  rate  constant  of  the  m-th  aqueous  complexation  reaction  [reaction-dependent]; 
=  Forward  rate  constant  of  the  m-th  aqueous  complexation  reaction  [reaction-dependent]; 

=  Number  of  dissolved  chemicals; 

=  Number  of  adsorbed  chemicals; 

=  Number  of  sizes  of  adsorbing  sites; 

=  Number  of  aqueous  complexation  reactions; 

=  Number  of  adsorption  reactions; 

=  Flow  rate  of  source/sink  [L3  solution/L3  matrix/T]; 

=  Concentration  of  the  i-th  adsorbing  site  [M/L3  solution]; 

=  Time  [T]; 

=  moisture  content  [L3  solution/L3  matrix]; 

=  Combined  first  order  degradation  rate  constant  of  the  i-th  dissolved  chemical  [1/T], 

=  Combined  first  order  degradation  rate  constant  of  the  i-th  adsorbed  chemical  [  1/T]; 

=  Combined  first  order  degradation  rate  constant  of  the  i-th  adsorbing  site  [1/T]. 

The  dispersion  coefficient  tensor  D  in  Eq.  (2.63)  is  given  by 

0D  =aT|  V 1 6 +(aL-aT)W/|  V  |  +0amx6  (2.71) 


where  | ' V  |  is  the  magnitude  of  V  [L/T],  6  is  the  Kronecker  delta  tensor,  ax  is  lateral  dispersivity  [L],  aL  is  the 
longitudinal  dispersivity  [L],  an,  is  the  molecular  diffusion  coefficient  [L2/T],  and  x  is  the  tortuosity. 


In  deriving  Eqs.  (2.68)  through  (2.70),  the  following  reactions  are  taken  into  account. 


(1)  Aqueous  complexation  reactions:  kmIb  and  lq^  as  backward  and  forward  reaction  rate  constants. 


E  ^.C,"  -  E  ^,C,"  me[l,N„] 


j  =  l 


j=l 


j=l  J=1 


Wvbmi 


(2.72) 

(2.73) 


where  R  is  defined  as  the  reaction  rate  of  the  aqueous  complexation  reaction. 


(2)  Adsorption/desorption  between  the  dissolved  phase  and  adsorbing  sites:  and  as  backward  and 

forward  reaction  rate  constants. 


A,c 

E 


«jq**E  <s; 

j=l 


me[l,N„s] 


(2.74) 


where  R  is  defined  as  the  reaction  rate  of  the  adsorption  reaction. 


(2.75) 


The  initial  and  boundary  conditions  used  to  solve  the  transport  governing  equations  are  stated  below . 
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Initial  Conditions: 


Cjw  =  c.-tiai(Xjy  z)  in  R 

(2.76) 

Dj  =  Djinitial(x,y,z)  in  R 

(2.77) 

Sj  =  Sjinitial(x,y,z)  in  R 

(2.78) 

Prescribed  Concentration  (Dirichlet)  Boundary  Conditions: 

c  w  =  on  gd 

(2.79) 

Variable  boundary  Conditions: 

n-(VCjw-0D-VCjw)  =  n-VCuVariable(xb,yb,zb,t)  if  n-VsO 

(2.80) 

n-(-eD-VCjW)  =0  if  n-V>0 

(2.81) 

Cauchv  Boundary  Conditions: 

n,(VCjw-0D,VCjw)  =  qjCauchy(xb,yb,zb,t)  on  Bc 

(2.82) 

Neumann  Boundary  Conditions: 

n,(-0D*VCjw)  =  qjNeumann(xb,yb,zb,t)  on  Bn 

(2.83) 

where  C™**,  D™*31,  and  are  the  initial  concentrations  of  the  j-th  dissolved  chemical,  the  j-th  adsorbed 

chemical,  and  the  j-th  adsorbing  sites,  respectively  [M/L3];  R  is  the  region  of  interest;  (xb,yb,zb)  is  the  spatial 
coordinate  on  the  boundary;  n  is  an  outward  unit  vector  normal  to  the  boundary;  CjDiricUet  and  CjVanable  are  the 
prescribed  concentration  of  the  j-th  dissolved  chemical  on  the  Dirichlet  boundary  and  the  specified 
concentration  of  water  through  the  variable  boundary,  respectively  [M/L3];  Bd,  and  Bv  are  the  Dirichlet  and 
variable  boundaries  respectively;  q.Cauchy  and  q.Neumann  are  the  prescribed  total  flux  and  gradient  flux  of  the  j-th 
dissolved  chemical  through  the  Cauchy  and  Neumann  boundaries  Bc  and  Bn,  respectively  [M/L2/T].  It  is 
noted  that  when  both  surface  and  subsurface  transport  are  simulated,  CjVanable  is  the  concentration  of  the  j-th 
dissolved  chemical  associated  with  the  corresponding  surface  nodes  if  it  is  not  dry  at  that  node.  If  the 
corresponding  surface  node  is  dry,  however,  the  infiltration  is  equal  to  the  throughfall  and  CjVanable  is  the 
concentration  of  the  j-th  dissolved  chemical  in  the  throughfall. 
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Section  3.  NUMERICAL  APPROACHES 


In  this  section,  we  present  the  numerical  approaches  employed  to  solve  the  governing  equations  of 
flow  and  transport  given  in  the  previous  section.  In  the  model,  transport  is  assumed  not  to  influence  flow 
and  a  one-time-lag  approach  is  taken  to  deal  with  the  interaction  between  surface  and  subsurface  systems. 
Three  time  scales  are  considered  in  the  model.  They  are  (1)  for  3-D  subsurface  flow,  (2)  for  3-D  subsurface 
transport  and  2-D  overland  flow/transport,  and  (3)  for  1-D  river/stream  flow/transport.  In  general,  a  3-D  flow 
time  step  may  include  several  2-D  flow  time  steps  and  a  2-D  flow  time  step  can  cover  many  1-D  flow  time 
steps.  The  time  scale  for  3-D  subsurface  transport  is  set  to  be  the  same  as  that  for  2-D  overland 
flow/transport  because  kinetic  chemical  reactions  are  taken  into  account.  During  each  3-D  flow  time  step, 
we  solve  3-D  subsurface  flow  by  employing  the  updated  2-D  flow  conditions  to  achieve  the 
surface/subsurface  interface  boundary  conditions  and  determine  the  infiltration/seepage  for  2-D  flow 
computation  included  in  this  3-D  flow  time  step.  During  each  2-D  flow  time  step,  we  first  solve  3-D  reactive 
chemical  transport  with  the  updated  2-D  transport  result  (i.e.,  at  the  previous  time)  used  for  implementing 
variable  boundary  conditions  on  the  interface  boundary  and  determine  the  dissolve  chemical  flux  through 
the  surface/subsurface  interface.  This  flux  is  actually  the  source/sink  to  2-D  dissolve  chemical  transport 
through  infiltration/seepage.  Then  we  solve  2-D  flow  equations  to  determine  the  water  stage/depth  and 
velocity  of  overland  flow.  Finally,  we  solve  2-D  reactive  chemical  transport  equations  for  the  distribution 
of  dissolved  chemicals,  sediments,  and  particulate  chemicals.  Within  a  1-D  flow  time  step,  the  river/stream 
flow  equations  are  solved  first  and  the  1-D  transport  equations  are  solved  by  using  the  newly-computed  flow 
results.  The  interaction  between  1-D  river/stream  and  2-D  overland  flow/transport  is  taken  into  account  by 
using  the  updated  computational  results.  Depth  or  stage  difference-dependent  fluxes  are  employed  to 
determine  the  flow  through  this  1-D/2-D  interface. 


3.1.  Solving  the  1-D  river/stream  flow  equations 

As  mentioned  earlier  in  this  report,  we  desire  to  implement  a  hybrid  model  to  accurately  simulate 
surface  water  flow  under  a  wide  range  of  physical  conditions  though  it  is  still  under  investigation  and  further 
study  is  required.  In  our  investigation  to  date,  we  would  apply  the  method  of  characteristics  to  solve  the 
dynamical  wave  model  and  would  use  the  Lagrangian  approach  to  solve  both  the  diffusion  wave  and  the 
kinematic  wave  models  in  the  hybrid  model  that  is  composed  of  the  aforementioned  three  wave  models.  In 
this  and  the  next  subsections,  we  will  present  the  numerical  approaches  used  in  the  method  of  characteristics 
and  the  Lagragian  approach  for  solving  the  1-D  river/stream  flow  and  2-D  overland  flow  equations, 
respectively.  In  either  approach,  the  Picard  method  is  employed  to  deal  with  the  nonlinearity. 

3.1.1.  Method  of  characteristics  for  1-D  dynamic  wave  model 


Recall  Eqs.  (2.1)  and  (2.2), 


dA  +  dQ 
dt  dx 


=  Ss  +  SR-SI  +  S,+S2 


dQ  +  duQ  =  _  A0(Zo  +  h) 
dt  dx  ^  dx 


+  — -  +u  rSR  -u  iSI+uY1S 
dx  R  1 


+u  Y2S.  + 


rps  _rpb 


(3.1) 

(3.2) 


We  also  have 
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aA  +  aQ  =  E  ah  t  d(utiBa) 
5t  dx  ‘  5t  dx 


(3.3) 


5B,  =  5B;  +  5B;0h 

dx  dx  dh  dx 


(3.4) 


dA  =  B  dh 

at  ‘  at 


B  *  +h 


dK 

ah 


ah 

at 


(3.5) 


and  assume 


aF. 


=  A 

dx  dx 


> 

la* 

=  _a_ 

„  .  3ii 
vB  h  — 

[  axj 

dx 

ax 

(3.6) 


where  v  is  the  eddy  viscosity  coefficient  [L2/T];  B,(x,t)  (=  B,*(x,h(x,t)))  is  the  top  river/stream  width  [L]; 
Ba(x,t)  (=  Ba*(x,h(x,t)))  is  the  average  river/stream  width  [L],  Thus,  Eqs.  (3.1)  and  (3.2)  can  be  rewritten  as 
follows  after  letting  H  =  h  +  Z,,  and  some  mathematical  manipulation. 


aH  aH 

_  4- 11  _  4-  _ 

at 

u -  ■ 

dx 

au 

aH 

1 -  4 

gsT' 

dx 

1 

-uS<,  + 

hB 

azn 


— (Ss  +Sr-Sj  +  Sj  +S2)  +u"“ 

B  s  R  1  1  2  B.  dx  dx 


— -  (3.7) 


vB  h 


au 

dx 


uSs+(ur-u)SR-(u  i-u)SI  +  (uY1  -u)S,  +(uYZ-u)S2  + 


.  Y2 


rps  _  rpb 


Thus,  Eqs.  (3.7)  and  (3.8)  can  be  written  in  matrix  form  as 

aE  A  aE  D 

—  +A —  =  R 

at  dx 


where 


E  =  {H  u}T 
hB„ 


A  = 


B. 


g  u 


and 


r  -  {  ri  r 2y 


(3.8) 


(3.9) 


(3.10) 


(3.11) 


(3.12) 


in  which 
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(3.13) 


R,  =^-(Ss+sR-sI+s1+s2) 


B 


nh^_+u^o 
B,  0X  0X 


1  0 


hB„  0x 


U  L^U 

vB  h — 

3  0X 


hB, 


-uSs  +  (u  r-u)SR-(u 1  -u)Sj  +  (u  Y1  -u)Sj  +(u 


,  Y2. 


u)S2  + 


rp$  _rpb 


(3.14) 


Eq.  (3.9)  can  be  written  as 


® +Ad—  =  RJ+RD 
0t  0x 


(3.15) 


where 


and 


RD  = 


RD! 

RD2 


0 

-  _J _ 01 

hBa  0x 


,  -  0U 
hB  v  — 

2  0X 


RJ  = 


"■ 


R,- 


< 


hBa  0u 
B,  0x 


> 


R2-RD2-g 


0H 

0X 


Eq.  (3.15)  can  be  further  written  as 


—  =  RJ+RD 
Dt 


where 

DE  =  0E  +Ad5E 
Dt  0t  0X 

Let  E#  be  the  solution  of 

SI  =  *,A-®  =  RJ 

Dt  6t  dx 


We  have,  fromEq.  (3.19) 


(3.16) 


(3.17) 


(3.18) 


(3.19) 


(3.20) 


(3.21) 
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E-Ep 


RJ+RD 


(3.22) 


where  Ep  represents  the  Lagrangian  value  of  E.  From  Eq.  (3.21) 

E#-Ep  _ „T 


(3.23) 


Subtracting  Eq.  (3.23)  from  Eq.  (3.22)  yields 


E-E# 


(3.24) 


Based  on  the  above,  we  mean  to  solve  Eq.  (3.21)  for  E#  at  first  and  solve  Eq.  (3.24)  for  E  based  on  E  .  Eq. 
(3.21)  is  solved  by  the  method  of  characteristics  as  follows. 


Eq.  (3.21)  can  be  written  as 


where 


il.  +  A—  =  RI 
dt  dx 


RI,]  |  R, 
RlJ  "  k-RD2 


The  eigenvalues  and  eigenvectors  of  A  are 


Xj  =  u  + 


1  hB,  1 

2  \  gBt  2 


(3.25) 


(3.26) 


(3.27) 


Xl  =  u 


l  hB,  l 

2\  gB,  2 


Now,  we  define 


c  c 

2g  2g 

1  i 

2  2 


(3.28) 


(3.29) 


1  1 


-1  1 
c 


(3.30) 
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Set 


0W  =  L~'0E  = 


1  1 


•■£  1 
c 


|0H| 
!  du  I 


Multiplying  both  side  of  Eq.  (3.25)  by  L1  yields 


L_1— +l_1ALL'1—  =  L  _1RI 

at  ax 


or 


aw 

at 


u  +c  0 
0  u  -c 


dW  _  T 


ax 


=  L  _1RI 


or 


where 


DW 

Dt 


c  = 


=  L_1RI 


ghBa 


N  B- 

Eq.  (3.34)  can  be  discretized,  in  time,  as  follows. 

H"*1  -Hj*  un+1-u* 


g 


c  Ax, 


i  _  g 


Ax, 


— RIj  +RIJ 

c 


(3.31) 


(3.32) 


(3.33) 


(3.34) 


(3.35) 


(3.36) 


_g  Hn+1  -H2  un+I-u2* 
c  Ax2  At2 


c 


(3.37) 


where  H,*,  u,\  and  Ax,  are  determined  by  backward  tracking  along  the  first  characteristic;  H2’,  u2‘,  and  Ax2 
are  determined  by  backward  tracking  along  the  second  characteristic. 


And 


tt  n+l  tt  _ 

=  a,Hkl  +3^  +a3 

(3.38) 

=  aiUkl+1  +a2UK  ‘  +a4 

(3.39) 

=  b,Hjri+b2Hjri+b3 

(3.40) 

-b,ii*1+Vp1+b4 

(3.41) 
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in  which  kl  and  k2  are  nodes  of  the  element  that  the  backward  tracking,  along  the  first  characteristic,  stops 
in;  j  1  and  j2  are  nodes  of  the  element  that  the  backward  tracking,  along  the  second  characteristic,  stops  in. 
(see  the  above  figure) 


Note:  1.  a},  a2 ,  bJf  and  b2  are  within  the  range  of  [0,1]. 

2.  We  may  use  two  given  parameters  to  determine  where  to  stop  in  the  backward  tracking:  one  is 
for  controlling  tracking  time  and  the  other  one  is  for  controlling  tracking  distance. 

Multiplying  Eqs.  (3.36)  and  (3.37)  with  cross-sectional  area  yields 

^5i(H-H1*)+-^(u-u1j+hBa  u+(PhK  +  Ss+SR-SI  +  S1+S2)u 

cAtj '  '  At,  '  '  Bt  dx  c  dx 


‘(^s  +^r "S, +S1  +S2)+(u  rSR -u  ‘Sj  +u  Y1 S,  +u  Y2S2)+-^—  vhBa~^ 


(3.42) 


-ghBa 

cAx„ 


(H-H2')^(u-<)'hB.  u+(^^k  +  ^s+Sr_S,  +  S|  +S2)u 


B.  dx  c  dx 


-  -^(Ss  *SR-VS,  +S2)+(u  -S»  -u  *Sj+u  YXh^-  ^(vhB. 

In  obtaining  Eqs.  (3.42)  and  (3.43),  the  following  relationships  have  been  employed. 


(3.43) 


rpb 

-  =  PhKU 


(3.44) 


Ts  _  b,tS 

P  P 


(3.45) 


When  Hj*,  u,*,  H2*,  and  u2’are  determined  explicitly  by  using  the  spatial  reachout  option  in  backward 
tracking  (i.e.,  track  backward  all  the  way  to  the  previous  time),  Eqs.  (3.42)  and  (3.43)  can  be  solved  for  (H#, 
u#)  node  by  node  as  follows. 

Eqs.  (3.42)  and  (3.43),  after  multiplied  by  and  At2,  respectively,  can  be  written  as 

anH  +  a12u  =  bj  (3.46) 


where 


a21H+a22u  =  b2 


ail  =  cBa 


(3.47) 


(3.48) 


a22=hBal+  Ax,  +(PhK  +  Ss+SR-SI  +  S1+S2)Ax1 

B.  dx  c  dx  ' 


(3.49) 
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hB>-“,)  .  ^  [  vhB  — ) 

At  dx  (  dx ) 

(3.55) 

Eq.  (3.54)  gives  that  H  =  H#,  while  Eq.  (3.55)  can  be  discretized,  in  the  finite  element  method,  as 

hB 

— ^[QA]{u}+[QD]{u}=  {QR}  +  {BQ} 

At 

(3.56) 

where 

Q\  -  E  /XeNpedR 

esM'  Re 

(3.57) 

QDu  =  E  f  VNaehvBaVNpedR 

(3.58) 

—  .  .  hB  u# 

QR,  -  E  !K 

eeMc  J  At 

(3.59) 

BQi  =  E  [  N>hBa|idB 

eeM  {  dx 

(3.60) 

in  Eq.  (3.60),  n  =  -1  for  upstream  boundary  nodes  while  n  =  1  for  downstream  boundary  nodes. 
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In  solving  Eqs.  (3.42)  and  (3.43)  at  boundary  nodes,  boundary  conditions  are  implemented  as 
follows.  A  boundary  node  can  be  either  an  closed  or  an  open  (flow-through)  boundary.  In  the  former  case, 
nothing  is  specified  and  velocity  at  the  node  is  set  to  zero  automatically  in  the  computer  code.  While  in  the 
latter  case,  H,  and  u  of  the  approaching  flow,  with  respect  to  the  characteristic  ongoing  direction,  must  be 
given  at  the  boundary  nodes.  Some  details  are  given  for  both  cases  below. 

<  Case  1  >  Closed  boundaries: 

If  the  closed  boundary  is  located  at  the  downstream  end,  only  sub-critical  flow  can  happen  because 
the  velocity  is  zero.  Under  this  condition,  one  characteristic  comes  from  the  outside  of  the  domain 
and  the  other  one  is  from  the  inside.  The  equation  associated  with  the  characteristic  from  outside 
will  be  replaced  by  u  =  0,  while  the  other  (either  Eq.  (3.40)  or  (3.41))  is  used  for  the  other 
characteristic.  On  the  other  hand,  if  the  closed  boundary  is  located  at  the  upstream  end,  either  sub- 
critical  or  super-critical  flow  can  occur.  If  the  flow  is  sub-critical,  again,  the  equation  associated 
with  the  characteristic  from  outside  will  be  replaced  by  u  =  0,  while  the  other  (either  Eq.  (3.40)  or 
(3.41))  is  used  for  the  other  characteristic.  If  the  flow  is  super-critical  then  both  u  and  h  are  set  to 
zero. 


<  Case  2  >  Open  boundaries: 

In  this  case,  three  types  of  boundary  conditions  can  be  given  for  sub-critical  flow  when  the 
propagation  direction  of  a  characteristic  is  inward  to  the  domain  of  interest  and  are  described  below. 


(1)  Given  time-dependent  flow  rate,  Q(t):  (used  for  upstream  open  boundaries) 


n*u 


_  Q  _  Q 

hBa  A 


(3.61) 


(2)  Given  time-dependent  water  stage,  Hb(t):  (used  for  either  upstream  or  downstream  open 
boundaries) 

H  =  Hb  (3.62) 


(3)  Given  rating  water  depth-dependent  flow  rate,  Q(h):  (used  for  natural  downstream  open 
boundaries  only) 


n*u 


_Q_  _  Q 

hBa  A 


(3.63) 


On  the  other  hand,  for  super-critical  flow  either  no  boundary  conditions  is  required  when  the  open 
boundary  is  located  downstream,  or  both  u  and  h  must  be  prescribed  when  the  open  boundary  is 
located  upstream. 


3.1.2.  The  Lagrangian  approach  for  both  1-D  diffusion  and  1-D  kinematic  wave  models 

Since  the  kinematic  wave  model  can  be  considered  to  be  a  simplified  form  from  a  mathematical  point 
of  view,  we  just  demonstrate  how  the  diffusion  wave  equations  are  solved  with  the  Lagranging  approach  in 
the  following.  Recall  Eqs.  (2.1)  and  (2.3) 
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(3.64) 


u 


0t 

0X 

-1 

R 

n 

1+(VZ0)2 

12/3 


d(Z0+h) 


Eq.  (3.64)  can  be  further  written  as 

D  0h  3(uhBa) 

D. -  + - 

0t  0x 


(V(Z0+h))1/2 


Ss+Sr"Si  +  Si+S2 


Substituting  Eq.(3.65)  into  the  second  term  on  the  left  side  of  Eq.  (3.66)  yields 


ahuBa  3h  .  aBa  du 

- =  uB„ —  +uh - +hBa —  = 

dx  dx  dx  dx 


'  „  u5B*  LT>  2  u  0R*^ 

uB  +uh - +hBa - 

a  ah  3  R  6h  / 


(3.65) 


(3.66) 


ill  +S  (3.67) 
dx 


where 


S  = 


~hBa  r 


2/3 


1  a2(Vh)  +  hBa  R2/3 


1  a(Z0  +  h)  0n 


1  +(VZ0)2]2/3  (V(Z0+h))1/2  0x2  n2  [l +(VZ0)2f/3  (VZ0)1/2  dx  dx 


-hBa 

R2/3  0ZO  _1 

'  a(z0+h)' 

2 

-5/4 

2 

0(ZO  +h)  02(ZO  +h) 

n 

1  +(VZ0)2J/3  dx  4 

dx  J 

Jmt 

5x  0x 2 

-hBa 

i 

m  1 

a(Z0+h)  2d. 

-i/3  aR* 

n 

1+(VZ0)2 

(V(Z0  +  h))1/2 

dx  3 

dx 

-hB 


r2/3  a(Z0+h)  _2 


n  (V(Zn  +h))1/2  dx  3 


1  + 


(vz0)2[5/3: 


az0  a2z0 


5x  dx  : 


+  hu- 


as; 

0X 


(3.68) 


Therefore,  Eq.  (3.66)  can  be  written  as 


B  —  + 
l0t 


w  ,  0B  *  .  D  2  u  0R* 

uB  +uh - +hB„ - 

a  0h  3  R  0h 


-  ss  .SR -S,  +S,  +S2 -S 

dx 


Eq.  (3.69)  can  be  further  written  as 

Dh 


Br57  =  Ss  +  Sr"Si  +  S>+S2"S 


(3.69) 


(3.70) 


where  the  following  characteristic  equation  applies. 


D  ,  0B*  ,D  2u0R* 

uBn  +uh - +hBa - 

dx  =  a  0h  3  R  0h 

dt  B, 


(3.71) 


Hence  the  solution  to  Eq.  (3.69)  is 
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h(x,t)  =  h(x0,0)+(Ss  +  SR-SI  +  S1+S2-S)t 


(3.72) 


in  which 


D  ,  dB*  ,B  2u0R* 

’  / - i; - dt 

0  * 


(3.73) 


A  nonlinear  iteration  loop  with  the  Picard  method  implemented  is  used  to  solve  Eqs.  (3.7)  and  (3.8) 
in  the  dynamic  wave  model  or  to  solve  Eqs.  (3.64)  and  (3.65)  in  the  diffusion  wave  model  during  each  time 
step. 

3.13.  Computation  of  water  budget  at  junctions 

In  the  model,  a  junction  is  considered  to  be  a  reservoir  and  water  budget  is  used  to  determine  the 
water  stage  there.  Thus,  the  governing  equation  to  compute  water  stage  at  a  junction  can  be  written  as 


dV.  ^ 
dt  m 


(3.74) 


where  Vj  is  the  volume  of  water  at  the  junction  [L3] ;  Q;  is  the  flow  rate  associated  with  the  junction  s  i-th 
connected  river/stream  reach  [L3/T];  ncr  is  the  number  of  river/stream  reaches  that  is  connected  to  the 
junction.  Since  Vj  can  be  expressed  as  a  function  of  water  depth  at  the  junction,  the  stage  at  the  junction  can 
be  determined  once  Vj  is  computed.  In  the  model,  Eq.  (3.74)  is  solved  implicitly  (i.e.,  within  the  nonlinear 
iteration  loop). 


3.2.  Solving  the  2-D  overland  flow  equations 

3.2.1.  Method  of  characteristics  for  2-D  dynamic  wave  model 


Recall  Eqs.  (2.9)  through  (2.11) 


dh  duh  dvh  cc  D  T 
—  + - + -  =  SS+R-1 

dt  dx  dy 


(3.75) 


duh  +  du2h  +  duvh  =  .gh^V5+^+i+(urR.uil)  +  V^ 
dt  dx  dy  dx  dx  dy  p 


(3.76) 


dvh  duvh  dv2h 


s  b 

X  -X 
y  y 


(3.77) 


dt  dx  dy  dy  dx  dy  p 

Let  H=h+Zo,  then  Eqs.  (3.75)  through  (3.77)  can  be  written  as  follows  after  mathematical 
manipulation. 


=  (SS*R-I>* 

dt  dx  dx  dy  dy  dx  dy 


(3.78) 
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dH 

dn 

0U 

i5F«  Jpyx' 

,  (ur-u)R-(u'-u)I  ^  Tx  Tx 

_  SS  u 

dx 

+u  — 
dx 

+  V - 

3y 

h 

[  0X 

dy  J 

h  hp 

h 

dH 

0  V 

0  V 

I 

dF  dF 

»y ..  yy 

.  (vr-V)R-(vi-v)Ii'ry_Xy 

_  SS  v 

’  dy 

+ u - 

0X 

+  V  — — 

0y 

h 

[  0X 

dy 

h  hp 

h 

Thus,  Eqs.  (3.78)  through  (3.80)  can  be  written  in  matrix  form  as 

5E.dE.  dE  D 
3t  dx  y  dy 


where 


E  =  {H  u  v}1 


(3.79) 


(3.80) 


(3.81) 


(3.82) 


u  h  0 
Ax  =  g  u  0 
0  0  u 


v  0  h 
0  v  0 
g  0  v 


(3.83) 


f  dZo  dzo 

SS  +R  -I+u — -  +v— — - 

i  dx  dy 

R,  b 

r=<R  ■  =  ■  1  aFxx  ■  9Fyx  .  (u  r-u)R  -(u  '  -u)I  ,  SS  u 

2  h  dx  dy  h  hp  h 

R3  r  ■  S  b 

1  ^xy.dFyy  t  (v  r  -V)R  ~(v  1  -V)I  ,  Xy  ~Ty  SS  V 
h  dx  dy  h  hp  h 

By  using  the  splitting  strategy  mentioned  in  Section  3.1.1,  Eq.  (3.81)  can  be  written  as 

—  +A  d—  +  A  d—  =  RJ+RD 
dt  x  dx  y  dy 


where 


u  0  0 
Axd  =  0  u  0 
0  0  u 


v  0  0 
Ayd  =  0  v  0 
0  0  v 


(3.84) 


(3.85) 


(3.86) 
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0 


RDj 

RD  =  < 

rd2 

►  =  < 

h 

rd3 

J_ 

h 

RJ  = 


RJj 

RJ2 

RJ, 


>  =  < 


dF  dF 

XX  1 

8x  dy  J 

3F  dF 
*y  +  y 
dx  dy 


R. -h— -h— 

1  dx  dy 

R2-RD2-g^ 


Eq.  (3.85)  can  be  further  written  as 


where 


DE 

Dt 


R3-RD3-g 


=  RJ+RD 


dx 

dH 

dy 


Let  E#  be  the  solution  of 


we  have,  from  Eq.  (3.89) 


DE  =  c)E +AddE +AddE 
Dt  at  x  dx  y  dy 


.  »+A‘*+A'®  =  RJ 
Dt  at  dx  y  dy 


E-Ep 

At 


=  RJ+RD 


where  Ep  represents  the  Lagrangian  value  of  E.  From  Eq.  (3.91) 

E#-Ep 


At 


Subtracting  Eq.  (3.93)  from  Eq.  (3.92)  yields 


E-E* 

At 


=  RJ 


RD 


(3.87) 


(3.88) 


(3.89) 

(3.90) 

(3.91) 


(3.92) 


(3.93) 


(3.94) 


Based  on  the  above,  we  mean  to  solve  Eq.  (3.93)  for  E#  at  first  and  solve  Eq.  (3.94)  for  E  based  on 
E#.  Eq.  (3.93)  is  to  be  solved  by  the  method  of  characteristics  and  can  be  written,  in  details,  as  follows. 
Eq.  (3.93)  can  be  written  as 


®  -RI 
x  dx  y  dy 


at 


(3.95) 
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where 


Rl/ 

R1 

RI  =  - 

RI, 

►  _  4 

r,-rd2 

.Wj 

R3-RD3 

Let 


A  *  k  Axkx  +  ^yky 


ukx+vky  hkx 


hk., 


the  associated  eigenvalues  and  eigenvectors  are 

K  =  ukx+vky 


X2  =  ukx+vky+Vgh 

Xz  =  ukx+vky-v/gh 


gkx  Ukx+vky 

gky 


0  ukx+vky 


e!  =  {°  ky  -kx}T 


e,  = 


y/jh  gkx  gkyl 

2  2  2  J 

y/gh  gkx  Sky 

T  ~T  2 


Now,  we  define 


Thus 


L  = 


Vjh  Vgh 

2  2 

gkX  gkx 


-k 


-1  _ 


2 

2 

gky 

gky 

x  2 

2 

0 

ky  -kx 

1 

kx  JS 

t/ih 

g  g 

_ 1_ 

kx 

y/gh  g  § 


Let 


(3.96) 

(3.97) 

(3.98) 

(3.99) 

(3.100) 

(3.101) 

(3.102) 
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0  ky  -kx 


_J_  K  K  dH 
aw  =  L_1aE  =  jjjfc  s  g  *  au 

1  K  k,  i3v- 


[  V'gh  g  g  J 

and  multiply  both  sides  of  Eq.  (3.95)  by  L'1.  Thus,  we  obtain 

L _1—  +L A  LL _1—  +L _1  A  LL _1~  =  L-'RI 

at  x  ax  y  By 


(3.103) 


(3.104) 


w.L"ai.5.L-' alH  -l-m 

at  x  Bx  y  By 


(3.105) 


where 


u 

gcky 

2 

gcky 

2 

V 

ggkx 

2 

gckx 

2 

hky 

c 

u+ckx 

0 

aw  + 

Bx 

_h^ 

c 

v  +cky 

0 

_hky 

c 

0 

u-ckx 

i K 

C 

0 

v  -cky 

c  =  ^gh 

After  arrangement,  Eq.  (3.106)  can  be  rewritten  as  follows. 


u 

0 

0 

[v  0  0 

0 

u+ckx 

0 

dW  +  o  v+ck  0 

ax  , 

0 

0 

u-ckx 

0  0  v-cky 

[,  3H  .  3H 
g  kv — -k  — 
y  Bx  By 

au  B\  ,  I 


+  _  k,k„—  +kvkv 4-  -k  k  I  ^  + 


r  x  y 


ax  x  x  ay 
au  ,  ,  B\ 


au  B\ 


11  1  1  UU  *  1_  ^  V  _\r  Yr  2-+—- 

[Tp  yax  x  xay"  x  yl  ay  ax;  jj 

For  a  general  consideration,  we  define  a  new  L'1  which  plays  the  following  transformation. 


dy  Bx  j 
au  Bv 


=  L^RI 


(3.107) 


(3.108) 
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0 


6W  =  L-’dE  = 


.(i) 


(i) 


-K 
kf  kf 
g  g 


J_  kf  kf 

egg 


aH 

au 

dx 


(3.109) 


Multiplying  both  side  of  Eq.  (3.95)  by  this  new  L'1  and  repeating  mathematical  manipulations 
involved  in  Eqs.  (3.106)  and  (3.108)  yields 


aw 

at 


u 

0 

0 

V 

0 

0 

0 

u+ckf 

0 

aw  , 

0 

v+cky(2) 

0 

u-c^® 

ax 

v-ckf 

0 

0 

0 

0 

aw 

ay 


+< 


■kf-cf 


y  -y  ax  ^  ^  ay  x  ^  { ay  ax  J 
^  y  ax  x  ^  ay  x  y  { ay  ax  , 


(3.110) 


L-1RI 


or 


where 


DWj 

k^-k^ 

Dt 

o 

DW, 

►  +  < 

S1 

s. 

►  —  i 

1  kf 

-Rii+— Ri2+— RI3 

Dt 

2 

egg 

DW3 

S3 

- 1  kf  ky(2) 

— RI.+— RL+-^RL 

Dt 

.  c  g  g 

(3.111) 


(3.112) 

(3.113) 

(3.114) 
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s  =  * 

Sz  c 


Sl=g(kff-kff' 
l  *  dx  ay 


kf’kf ♦kfk^—  -kf’k?’ 

^  ^  dx  ^  x  dy  ^ 


f  du  dv^ 


S  =  _ !l 

Ss  c 


[dy  dx  )  \ 

k.'V-^V  — -kfkff  au  +  8v' 
^  ^  dx  dy  \  dy  dx  t 


(3.115) 

(3.116) 

(3.117) 


Note:  Diagonalization  can  be  achieved  under  special  selections  of  kj1*,  kf',  kj2>,  and  ky!2>  to  make  zeros 
of  S„  S2,  and  S3. 


Eq.  (3.107)  can  be  discretized,  in  time,  as  follows. 


,,  n+1 _ ,,  *  •■rn+1  —  v 

kf-^—L-kf^— U si  =  ky(1)Ri2-kfRi3 


At, 


Aii 


(3.118) 


!  Hn+1  -H2*  kf  un+1  -u2*  ky(2)  V-1  -v2*  _  1  DT  k 


(2) 


(2) 


At0 


g  At2 


g  Ax, 


+  S2  =  -RI,+— Rl2+^-RI3  (3.119) 


_1  Hn+1-H3*  kf  un+1-u3*  +k^: 


,<2)  ..n+1 


v"T1  -  v3  -1  kf  k' 

3  O  Xr.T  X  r,T  +_J_RJ  (3.120) 


.(2) 


At, 


g  At3 


g  At, 


.+S3  = 


where  iif  vf  and  Atj  are  determined  by  backward  tracking  along  the  first  characteristic;  H2 ,  u2 ,  v2 ,  and 
At2  are  determined  by  backward  tracking  along  the  second  characteristic;  H3 ,  u3 ,  v3 ,  and  At3  are 
determined  by  backward  tracking  along  the  third  characteristic;  and 


*  n+1  n+1  n+1  n+1  ,  _ 

U1  *  aiUkl  +a2Uk2  +a3Uk3  +a4Uk4  +a6 


*  n+1  n+1  n+1  n+1 

V1  *  aiVkl  +a2Vk2  +a3Vk3  +a4Vk4  +a7 


h2  =  b1Hjri+b2Hjri+b3Hjri+b4Hjri+b 


*  ,  n+1  i  n+1  *  n+1  L  n+l  i 

u2  =  bjUj!  +b2uj2  +b3uj3  +b4uj4  +b6 


n  +  1 


n  +  1 


*  *  n+1  i  n+1  i  n+l  *  n+1  i 

v2  =  bj  Vji  +b2Vj2  +b3Vj3  +b4Vj4  +  b7 

H3*  =  djic;1  +d2H^+1  +d3H^3+1  +d4ic;1  +d 


*  j  n+1  j  n+1  i  n+l  ,  ,  n+i  j 

u3  =  diUml  +d2um2  +d3um3  +d4um4  +d 


n+1 


n+1 


(3.121) 

(3.122) 

(3.123) 

(3.124) 

(3.125) 

(3.126) 

(3.127) 
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(3.128) 


,  n+1  j  n+1  ,  n+1  i  n+1  , 

=  dlVml  +d2Vm2  +d3Vm3  +  d^V'‘  + 


J4vm4 


dv 


in  which  kl,  k2,  k3,  and  k4  are  nodes  of  the  element  that  the  backward  tracking,  along  the  first  characteristic, 
stops  in;  j  1,  j2,  j3,  and  j4  are  nodes  of  the  element  that  the  backward  tracking,  along  the  second  characteristic, 
stops  in;  ml,  m2,  m3,  and  m4  are  nodes  of  the  element  that  the  backward  tracking,  along  the  third 
characteristic,  stops  in.  (see  the  following  figure) 


Note:  1.  a}  -  a#  b}~  b4,  and  d,  ~  d4  are  within  the  range  of  [0,1]. 

2.  We  may  use  two  given  parameters  to  determine  where  to  stop  in  the  backward  tracking:  one  is 
for  controlling  tracking  time  and  the  other  one  is  for  controlling  tracking  distance. 


Eqs.  (3.1 18)  through  (3.120)  can  be  further  expressed  as 

k(l)  ,  k(1)/  V  k(1)  kU) 

-JUu-uJ — i_  v-v1*)+— (hK  +  SS+R-I)u-  — (hK  +  SS+R-I)v 

At.'  '  Ax'  h  h 

(3.129) 

A  1.(1) 3H  lt0)UrR-B,I  u(l)  vrR-v‘I  ,  (1)  Xx  (1)  Ty 

=_gl y  ^  x  ~%J  K  **  hp  **  hp 


1 

cAt2 


kf  kf  u  dZ0  v  3Z0 

+  — (hx  +  SS  +  R  -  I)u  +  — (hK  +  SS  +  R-I)v  -  —  — -  — 

gh  gh  c  dx  c  ay 


i  (2) 

=  -(SS+R-I)  +  —  — 

c  g  h 


i  (2) 

ky  VrR-V‘I 

+  — - 

g  h 


kf  <  kf  $ 

+ - +  — i — 


g  hp  g  hp  c 


y  y  8x  x  ^  dy  ^  y  {  dy  8xt 


(3.130) 
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— — (h-H3*)+-^(u-u3*)  +  -^—  (v-v3*) 
cAx3  '  3/  gAx3 '  3/  gAx3 '  3/ 

k(2)  k(2)  u  aZn  v  dZ0 

+  — —  (hK  +  SS  +  R-I)u  +-^— (hK  +  SS  +  R-I)v  +  — + — — — 
gh  gh  c  dx  c  0y 

c  g  h  g  h 


(3.131) 


^  tf  +  kf  +  t  jo^oav  _  |U  Jli 

g  hp  g  hp  cp  ^  6x  dy  \dydx) 

In  obtaining  Eqs.  (3.129)  through  (3.131),  the  following  relationships  have  been  employed. 

_b 


—  =  KU 
hp 

(3.132) 

—  =  KV 

(3.133) 

hP 

.  _ ,  au 
xx "  e%xdx 

(3.134) 

,  d\ 

•  =  he  — 

yy  yy  dy 

(3.135) 

,  ,  au  av 

.  =  he  —  +  — 

5“  xy[  dy  dx 

(3.136) 

When  u,*,  v,\  H2*,  u2*,  v2\  H3*,  u3‘,  and  v3*are  determined  explicitly  by  using  the  spatial  reachout 
option  in  backward  tracking  (i.e.,  track  backward  all  the  way  to  the  previous  time),  Eqs.  (3.129)  through 
(3.131)  can  be  solved  node  by  node  (H#,  u#,  v#)  as  shown  below. 

Eqs.  (3.129)  through  (3.131),  after  being  multiplied  by  water  depth  (i.e.,  h),  can  be  written  as 


where 


ai2u+ai3v  =  bi 

(3.137) 

a2IH  +  a22u+a23v=b2 

(3.138) 

a31H+a32U+a33V=b3 

(3.139) 

=  k(1)  — +hK  +  SS+R-I 
^  [At, 

(3.140) 
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>13  =  -K 


(1) 


Ax, 


+hK+R-I 


(3.141) 


hkf  hk^  (  (1)3Hl 


.(1) 


bj  =  — — r— vi  -gh.  -y  .  , 

1  At,  At,  V  dx  dy 

+lr(1)(u  rR  -u  *1)  -k^v  rR  -  v  >1)  +k^- -K- 

y  3  n  n 


(l)Tx  .  (l)Ty 


(3.142) 


>21 


cAt, 


^22 


(2) 


h  +— (hK+SS +R-I) 


^3 


(2) 


gAt2  g 


h  +— (hK  +  SS  +R-I) 


gAt,  g 


h  gZp 
c  dx 

h  dZo 

c  dy 


(3.143) 

(3.144) 

(3.145) 


.(2) 


(2) 


,  .  (2)  hv&)  ,  ifW  u 

b,  =  — ^ — H2  +  — — — u2  + — t^-v2*  +  — (SS  +  R  -I)  +■— —  (u  rR-u '!)  +  — ^— (v  rR  -v '!) 


c  At. 


gAt2  gAt2 


g 


g 


(3.146) 


g  P  g  P  c 


u  (2)u  C2)  9U  .  (2).  (2)  5V  _  ,  (2),  (: 
yky  0x  **  kx  6y  kx  ^ 


(2) 


{  du  t  dv 
dy  dx 


(2) 


a32 


*33  -  kf 


-h 

a,,  =  - 

31  cAt, 


h  +  — (hK  +  SS  +R  -I) 


gAt,  g 


h  +— (hK  +  SS+R-I) 


gAt,  g 


h  dZo 
c  dx 

h  dZo 
c  dy 


(3.147) 

(3.148) 

(3.149) 


.(2) 


.  k(2)  .k(2) 

b,  =  -^iLH,*+— ^u,*+— ^-v;-il(SS+R-I)+^(urR-uiI)+-^(vrR-vII) 
cAt,  gAt,  gAt3  c  g 


.(2) 

"y 


g 


(3.150) 


kf  <+^i+h2 


\  1 


k®k®ii  h.  kf>kf>^  -  kfW  , , 

y  ^  dx  x  dy  y  {  dy  dx )  J 


g  P  g  P  c 

Therefore,  we  solve  Eqs.  (3.137)  through  (3.139)  for  H#,  u#,  v#  arithmetically.  Now,  we  can  solve 
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Eq.  (3.94)  as  follows.  Eq.  (3.94)  can  be  written  in  details  as 

H-H#  „ 


At 


h(u-u#) 

At 

h(v-v#) 

At 


dF  3F 

xx  + _ yx 

dx  dy 
dF  dF 

xy  ,  yy 
dx  dy 


(3.151) 


(3.152) 


(3.153) 


Eq.  (3.15 1)  gives  that  H  =  H*,  while  Eqs.  (3.152)  and  (3.153)  can  be  discretized,  in  the  finite  element 
method,  as 


— *[QA]{u}  +[QD1]{u}  +[QD4]{v}=  {QRMMBQ1} 
At 


At 


where 


[QA]{v)*[QDJHu)*[QD3](v|=  (Qr!}+(BQ2) 


QA«  ■  £  /XXdR 

eeM,  J 


e  R. 


he  0 

qdJ-E/vn;- 

eeM,  J 


e  R„ 


0  he 


xy 


VNftedR 


QDij  •  E  /  VN.‘- 

eeM,  i 


0  he 
0  0 


xy 


•VNpedR 


QD3  -  £  /  vn; 

esM,  t 


Ky  0 

0  he 


yy 


VNpedR 


QDij  -  E  /  vn;- 

'eM«r, 


0  0 
Ky  0 


•VNpedR 


QR‘  -  £  fN.'— <® 


eeMe  £  At 


(3.154) 


(3.155) 


(3.156) 


(3.157) 


(3.158) 


(3.159) 


(3.160) 


(3.161) 
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(3.162) 


Nj 


hv^ 

At 


dR 


BQ/  =  E  r 


N> 


hexx 

0 

•  Vu  +N0en- 

0 

0 

0 

hV 

he*y 

0 

■Vv 


dB 


BQi2  =  E  P 

e6M  «B. 


N> 


0 

h€*y 

•Vu+N'n- 

h€xy 

0  ' 

0 

0 

tt 

0 

heyy. 

Vv 


f  dB 


(3.163) 


(3.164) 


In  solving  Eqs.  (3 . 1 29)  through  (3 . 1 3 1 )  at  boundary  nodes,  we  demonstrate  how  boundary  conditions 
are  implemented  as  in  the  following.  An  overland  boundary  segment  can  be  either  a  closed  or  an  open  (flow¬ 
through)  boundary.  In  the  former  case,  nothing  needs  to  be  specified.  While  in  the  latter  case,  H,  u,  and  v 
of  the  approaching  flow,  with  respect  to  the  characteristic  ongoing  direction,  must  be  given  at  all  segments 
(or  segment  nodes).  Some  details  are  given  for  both  cases. 


<  Case  1>  Closed  boundaries 

The  first  characteristic  equation  is  always  replaced  by  the  following  equation,  representing  a  zero 
normal  flux  on  the  boundary. 

n-u  =  0  (3.165) 

where  n  is  the  outward  unit  normal  vector  of  the  boundary  segment.  Tracking  along  the  closed 
boundary  will  be  used  for  the  second  and  third  characteristics  if  necessary. 

<  Case  2  >  Open  boundaries: 

The  first  characteristic  equation  is  always  replaced  by  the  following  equation,  representing  a  zero 
lateral  flux  on  the  boundary. 

n/u  =0  (3.166) 

where  nx  is  the  unit  vector  parallel  to  the  segment.  Either  the  second  or  the  third  characteristic 
equation,  depending  on  the  propagation  direction,  will  be  replaced  by  the  boundary  condition 
specified  on  the  boundary.  There  are  four  types  of  boundary  conditions  considered  here.  Only  when 
the  propagation  direction  is  inward  to  the  domain  of  interest,  will  the  replacement  be  employed. 

(1)  Given  time-dependent  normal  flux,  q(t):  (used  for  upstream  open  boundaries) 

n-u  =  ^  (3.167) 

h 

(2)  Given  time-dependent  water  stage,  H(t):  (used  for  either  upstream  or  downstream  boundaries) 

H  =  Hb  (3.168) 

(3)  Given  water  depth-dependent  normal  flux,  q(h):  (used  for  natural  downstream  open  boundaries 
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or  river/stream-/junction-related  boundaries) 


n-u  =  — 


(3.169) 


(4)  Given  stage  difference-dependent  normal  flux,  q(AH):  (used  for  river/stream-/juncti on-related 
boundaries) 


% 

n-u  =  — 

h 


(3.170) 


As  mentioned  earlier  in  Section  3.1.2,  both  depth  and  velocity  must  be  specified  on  the  boundary 
where  supercritical  flow  occurs. 

3.2.2.  The  Lagrangian  approach  for  both  2-D  diffusion  and  2-D  kinematic  wave  models 


Recall  Eqs.  (2.9),  (2.12),  and  (2.13) 

dh  dhu  dhv 


+  =  SS+R-I 

dt  dx  dy 


where 


u  = 


v  = 


-1 

h 

n 

1+(VZ0)2 

-1 

h 

n 

1+(VZ0)2 

12/3 


d(Zn+h) 


[V(Zn  +  h)]1/2  ax 


12/3 


1 


a(z0+h) 


[V(Z0  +  h)]1/2  ay 


dh  +  5u  dh  +  5v  dh  =  Ss+R-I-X-Y 


Substituting  Eqs.  (3.168)  and  (3.169)  into  Eq.  (3.167)  yields 

dh  +  5u  dh  +  5v  dh 
dt"  3  dx  3  dy 

a2(Z0+h)  i 


(3.171) 


(3.172) 


(3.173) 


(3.174) 


where 


X  = 


-1 


.5/3 


1 


.5/3 


3(Z0  +  h)  0n 


"  [lx(VZ/f  WV'M1'2  dx2  nJ[l,(VZ„)f5[V(Z„th)]'”  Sx 

-2  h5/3  a(Z0+h)  _i 


-1 

'  a(z0+h)' 

2 

4- 

'  (Zo+h)' 

2 

4 

ax  J 

t  dy  J 

n  [l  +(VZ0)2]2/3  ax  4 

d(Z0  +  h)  d2(Z0  +  h)  d(Z0+h)  d2(ZQ  +  h) 


1-5/4 


(3.175) 


dx  dx2  ay  dxdy 

2  h5/3  a(Z0  +  h)  _2 


n  [V(Z0+h)]1/2  ax  3 


-[l+(VZ0): 


,2>5/3 


dZ0d2Z0|dZ0d2Z0 


dx  dx2  5y  dxdy 
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,5/3 


Y  = 


1  d2(Vh>  1 


,5/3 


1  d(Z0  +  h)  an 


■>  [l  *(VZ0)z]“  [V(Z0+h)]1'2  ay2  n2[l.(VZ/f3[V(Z0+h)]‘'2  By  By 
-2  h5/3  d(Z0  +  h)  _i 


-1 

'  a(z0+h)' 

2 

+ 

'  (Vh)" 

2 

4 

0X  J 

3y  J 

d(z0 + h)  a2^ + h)  0(zo + h)  a2(z0 + h) 


0x  0x0y  0y  0y: 


±  h” - 8<vh)-^[i  .(VZ.)2]- 

n  [V(Z0  +  h)]1/2  3y  3  1  J 


azo02zo  az0  a2z0 


5x  8x0y  6y  dy: 


Eq.  (3.174)  can  be  further  written  as 


—  =  SS+R-I-X-Y 
Dt 


where  the  following  characteristic  equations  apply. 


dx  _  _5  u 
dT  "  3° 


dy  =  5  y 

dt  3 


(3.176) 


(3.177) 

(3.178) 

(3.179) 


Hence  the  solution  to  Eq.  (3.177)  is 

h(x,y,t)  =  h(x0,y0,0)  +  (R-I-X-Y)t  (3. 1 80) 


in  which 


x_xo  =  /  3udt 


y-y0  =  /  3vdt 


(3.181) 


(3.182) 


A  nonlinear  iteration  loop  with  the  Picard  method  implemented  is  used  to  solve  Eqs.  (3.78)  through 
(3.80)  in  the  dynamic  wave  model  or  to  solve  Eqs.  (3.171)  through  (3.173)  in  the  diffusion  wave  model 
during  each  time  step. 


3.3.  Solving  the  3-D  subsurface  flow  equations 

The  Richard’s  equation  is  discretized  with  the  Galerkin  finite  element  method  in  space  and  with  the 
finite  difference  method  in  time.  In  the  model,  the  steady-state  version  of  subsurface  flow  equations  can  be 
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solved  for  determining  the  initial  subsurface  flow  condition  when  boundary  conditions  are  complicated 
and/or  unsaturated  zones  are  taken  into  account.  The  details  of  solving  the  Richard  s  equation  has  been 
described  elsewhere  [Yeh  et  al,  ]  and  are  not  to  be  presented  here. 

To  adequately  handle  the  flow  through  surface/subsurface  interface,  the  following  points  have  been 
implemented  in  the  computer  code. 

(1)  If  the  flow  direction  is  determined  from  subsurface  to  surface,  seepage  occurs  when  the  pressure  head 
at  the  corresponding  subsurface  node  is  positive;  otherwise,  evaporation  happens. 

(2)  When  rainfall  is  negative,  it  appears  as  a  sink  to  the  surface  system  when  the  overland  is  wet  (i.e.,  water 
depth  is  greater  than  zero);  otherwise,  it  is  a  sink  to  the  subsurface  system. 


3.4.  Solving  the  1-D  river/stream  transport  equations 

In  solving  the  transport  equations  of  both  1-D  river/stream  and  2-D  overland,  the  following  strategy 
is  employed. 

<i Stategy>  Using  the  predictor-corrector  scheme  to  deal  with  transport  equations  of  mobile  materials. 

In  solving  Eqs.  (2.23),  (2.25),  and  (2.26),  the  following  strategy  is  employed.  All  the  three  equations 
can  be  expressed  in  the  following  form. 

A—  =  L(C)  +RHS  (3.183) 

dt 

where  C  can  be  Sn,  C",  or  SnCms,  L  is  the  diffusion  operator,  and  RHS  represents  source/sink  terms. 

Thus,  we  can  solve  Eq.  (3.183)  with  the  following  two  steps. 

First,  we  solve 

n  n  + 1/2  _  r  n 

A— - —  =  L(Cn*1/2)+(RHS)n  (3.184) 

At 

Second,  we  solve 

rN*i  _r  n  , 

A- - —  =  L(Cn  +  1/2)+(RHS)n+1  (3.185) 

At 

We  can  also  subtract  Eq.  (3.184)  from  Eq.  (3.185)  to  yield 

f  N+l  _pN  +  l/2 

A- - - -  =  (RHS)n  +  1-(RHS)n  (3.186) 

At 

The  advantage  of  solving  Eq.  (3.186),  rather  than  Eq.  (3.185),  is  that  we  can  compute  CN+1  node  by 
node  when  CN+I/2  is  previously  determined.  Thus,  we  first  solve  Eq.  (3.184)  for  CN+1/2  (the  intermediate 
value)  in  the  so-called  predictor  step  and  perform  the  so-called  corrector  step  by  solving  Eq.  (3 . 1 86)  to  obtain 
CN+1.  To  avoid  negative  numerical  results  in  solving  Eq.  (3.184),  the  following  equation  is  actually  solved 
when  (RHS)N  is  negative. 
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aCn*1/2-Cn  (RHS)ncN„/2  _  L(c n  + 1/2) 

At  Cn 

Consequently,  we  are  solving  the  following  equation  in  the  corrector  step. 

a£!^  -  (RHS)N*i-(RHSf 

At  Cn 

With  the  finite  element  approximation,  Eq.  (3.184)  can  be  discretized  as  follows. 

(  [QA] 


At 


+  w  [QD]  {C}  =  {QR}  +(l-w)[QD]  {Cp}  +  {QB} 


where  the  associated  element  matrices  are  defined  as  follows. 

[QA]e  =  J  NjANjdx 


(3.187) 


(3.188) 


(3.189) 


(3.190) 


.  dNj  dN, 
[QD]e  =  f — -AK — ±dx 
i  dx  x  dx 


(3.191) 


{QR}e  =  j*Ni(RHS)Ndx 

{QB  }e  - 


-  AK— | 

dx  J 

UA  /  boundary 


(3.192) 


(3.193) 


It  is  noted  that  both  [QA]e  and  {QR}e  must  be  lumped  such  that  Eqs.  (3.184)  and  (3.186)  are  solved 
consistently.  Also,  boundary  conditions  for  mobile  materials  are  implemented  in  this  predictor  step. 

In  the  following,  we  show  the  procedures  of  solving  the  transport  system  in  Section  3.3.1,  to 
determine  the  concentrations  of  chemicals  and  sediments  at  junctions  in  Section  3.3.2,  and  to  give  estimation 
of  deposition  and  erosion  in  Section  3.3.3. 

3.4.1.  Procedures  of  solving  1-D  river/stream  transport  equations 

Recall  Eqs.  (2.35)  through  (2.39)  and  express  them  in  the  Lagrangian  form  for  mobile  materials  as 

follows. 

For  the  continuity  equation  of  suspended  sediment: 


dSn  dSn  0Sn 

A — A  =  A — -+Q — -  =  0 
dt  3t  dx 


(3.194) 


ds  5 

3S 

A  n-  d 

AK — - 

= 

dt  dx 

x  dx 

M, 


ns+PRn-PDn+Mnos]-[SS+R-I  +  R1+R2]Sn  ne[l,Ns]  (3.195) 


For  the  continuity  equation  of  bed  sediment: 
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-=D-Rn  ne[l,N  ] 


(3.196) 


For  the  continuity  equation  of  dissolved  chemical: 


dC;W  5CjW  3C; 

A — -  =  A — —  +Q — -  =  0 

dt  at  ax 


(3.197) 


dqw  a  ac" 

A — AK  — 
dt  dx  dx 


Mr*Ak,V£  k*SnAC„‘.j;  CMnPCmb  I 


*E  «-b;>CA  fi  (9i*)‘ 

m=l  i-»  K  j=1 


(3.198) 


-  X'A+Ak?+£  SnAk^[+E  MnPk^f +  SS  +  R-I+Rj+R2  C,v 

n=l  n=l 

For  the  continuity  equation  of  particulate  chemical  on  suspended  sediment: 


d(SnCn-)  =  Ad(SnCjj)  iQa(sncn:)  =  0 


ie[l,Nl 


(3.199) 


dt  dx 


ka(S-°] 

ax 

[“  +  knf  S„  A  C:w  +  B  — 

m  m  n  1 


n  /o  r  s\  ,  cos 


(3.200) 


-  A^A+k*A+SS+R-I+RI+R2](SnCI*)  ne[l,Ns],  ie[l,Nc] 

For  the  continuity  equation  of  particulate  chemical  on  bed  sediment: 

‘  <'k-l,M"c'w  ♦■‘-“K0*  (3.201) 

ne[l,Ns],ie[l,Nc] 

We  solve  the  transport  system  by  achieving  the  following  steps. 

Step  1  Solve  Eqs.  (3.194),  (3.197),  and  (3.199)  to  obtain  the  Lagrangian  values  for  suspended  sediments, 
dissolved  chemicals,  and  particulate  chemicals  on  suspend  sediments. 

Step  2  Solve  Eqs.  (3.195)  and  (3.196)  for  Sn  and  Mn. 
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(a)  Solve  Eq.  (3.195)  with  all  source/sink  terms  evaluated  at  the  previous  time,  as  described  in  Eq.  (3.184). 
(the  predictor  process  of  Eq.  (3.195)) 

=>  Obtaining  the  intermediate  value  for  suspended  sediments. 

(b)  Prepare  the  corrector  form  of  Eqs.  (3.195)  as  described  in  Eq.  (3.186).  It  can  be  written  as  follows. 

/o  \N+1  /  c  \N+l/2 


(sn)N+1-(snr 


=  (RHSns)N+1-(RHSns)N  (if  (RHSns)N*o) 

=  (RHSns)N^  -  (RHS"  }  (Sn)N*1/2  (if  (RHSns)N<o) 
(Sn)N  ' 


(3.202) 


ne[l,Nl 


where 


(RHSns)  =  [Mns+PRn-PDn+Mnos]+[SS+R-I  +  R,+R2]Sn  ne[l,Ns]  (3.203) 

(c)  Solve  Eq.  (3.202)  and  Eq.  (3.196)  node  by  node  with  the  Picard  method  to  obtain  the  concentrations  of 
suspended  and  bed  sediments. 

Note:  In  Eqs.  (3.195)  and  (3.196)  both  D„  and  Rn  need  to  be  evaluated  first,  while  in  Eq.  (3.195)  A,  Q,  K„ 
P,  R,  I,  R„  R2,  M„s,  and  Mn05  are  either  given  or  determined  after  the  flow  equations  are  solved. 
During  each  iteration  in  (c),  both  Eq.  (3.202)  and  (3.196)  are  solved  with  the  time-implicit  scheme. 

Step  3  Solve  Eqs.  (3.198),  (3.200),  and  (3.201)  for  Qw,  Cms,  and  Cmb. 

(a)  Solve  Eqs.  (3.198)  and  (3.200)  with  all  source/sink  terms  evaluated  at  the  previous  time,  as  described  in 
Eq.  (3.184).  (the  predictor  process  of  Eqs.  (3.198)  and  (3.200)). 

(b)  Prepare  the  corrector  form  of  Eqs.  (3.198)  and  (3.200)  described  in  Eq.  (3.186).  They  can  be  written  as 
follows. 

For  dissolved  chemicals: 

/  /-<  w  \N + 1  //-'w\N*l/2 


(c;r-(c,w) 


=  (RHSic)N+1-(RHSic)N  (if  (RHS^)^) 

=  (RHSiT*1  -  (RHSi  —  (O^2  (if  (RHSjC)N<o)  ie[l,N  ] 

(Cjw)N  '  ; 


(3.204) 


where 
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(3.205) 


(RHSic)  =  Mr +Ak,abpi+i:  k^snAc^E  CMnpcmb +Mr-Mr +Mr 

n=l  n=l 


X'A*Ak f+t M.pC-SS-R-I+R.^Rj  c; 


Nrx  Nc  „c  kif  Nc 

-  e  (<  -  bi>kfA  n  (cr)b-^n 

®-l  j=1  km  j=1 


For  particulate  chemicals  on  suspended  sediments: 


(snON+1-(snO 


s  \N+l/2 


ie[l,Nl 


=  (RHSj|)N+1  -(RHS^)n  (if  (RHS^)n^o) 


(3.206) 


(RHSJ) 


N+l  (RHS^) 


—  (Cn-)N+1/2  (if  (RHSi*)n<0 )  ne[l,Ns],  ie[l,Nc] 

SxN  '  1 

ii  / 


where 


(RHS,*)  =  M“.knfs„AC-.B^(M„C„b)-B2i(SnC,-)*Mir 

Mn  Sn  j  (3.207) 

-’^A+kjA+SS+R-I+R^RjjcS.O  ne[l,Ns],  ie[l,Nc] 

(c)  Solve  Eqs.  (3.204),  (3.206),  and  (3.201)  node  by  node  with  the  Newton-Raphson  method. 

Note:  In  Eqs.  (3.204 ),  (3.206 ),  and  (3.201 )  S„  and  M„  are  computed  in  Step  1,  while  A,  Q,  B,  P,  K„  reaction 
rate  constants,  stoichiometry,  1-st  order  decay  constants,  partial  atmospheric  pressure,  and 
sources/sinks  are  either  given  or  determined  after  the  flow  equations  are  solved. 

To  achieve  the  (c)  of  Step  3,  the  following  residual  equations  are  constructed. 

For  dissolved  chemicals: 

(RESjC) 


=  a[(C;W)n+1  -  (Cj  W)N  * 1/2  ]  -  6t  [(  RHSj*  )N  * 1  -(RHSiC)N]  (if  (RHSjTao) 


=  A[(C  w)N+1-(C:W)N+1/2l-6t  (RHSiC)Ntl  -  (RHS‘  }  (Ciw)N»1/2 
1  1  J  (CjW)N 


(if  (RHSiC)N<()) 


(3.208) 


ie[l,N  1 
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For  particulate  chemicals  on  suspended  sediments: 

(RES,*) 

=  A[(SnON+1-(SnON+1/2]-6t[(RHS^)N+1-(RHS^)N]  (if  (RHS,*)N;>o) 


=  A[(SnON+1-(SnON  +  1/2]-6t 


S\N 


(RHS^)n+1  - (RHS"-  (SnC^)N+1/2 
(SnC^)N 


(3.209) 

(if  (RHS^)n<o) 


ne[l,Ns],  ie[l,Nc] 

For  particulate  chemicals  on  bed  sediments: 

(RBSj)  -  (M„C„b)N*1-(M,,Ci:)N-At(RHS„b)N*'  ne[l^,l,  ie[l,Nt]  (3.210) 

The  associated  Jacobian  entries  are  thus  computed  as  shown  in  the  following. 

For  dissolved  chemicals: 
dfRESj11) 


3(CD 


w\N+l 


=  6aA+6a6t 


A^A  +  SS  +R-I+R,  +R2+Akiaf+52  SnAk*f+£  MnPkb( 


n-1 


n=l 


6t 


E 


m=l 


N,  c  «  ,  NC 

i  rf.  c  TT 


c^<c,-)b--'  n  <sy*-KC(.crf“  n  «vr 


(3.211) 


ie[l,Nl 


d(RES;C) 

3(SnON+1 


A,6tk*A 


0(RESjC) 

d(MnC^b)N+1 


-6a6tCP 


For  particulate  chemicals  on  suspended  sediments: 


a(REs^) 

6(C,W)N+1 


-6u6tk^fSnA 


ne[l,Ns],  ie[l,Nc], 

ne[l,Ns],  ie[l,Nc] 

ne[l,Ns],  ie[l,Nc] 


(3.212) 


(3.213) 


(3.214) 


a(RES^) 

a(snON+1 


=  6ilA  +  6il6tB^+8il6t 

n 


A^A+kjA+SS+R-I+Rj+Rj 


ne[l,Ns],  ie[l,Nc] 


(3.215) 
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d(RES^) 

a(Mnc„b)N+1 


Rn 

■6;1 6tB — - 


For  particulate  chemicals  on  bed  sediments: 


ne[l,N  ],  ie[l,Nl 


(3.216) 


a(RESm°)  bf 

-  =  -  6^  At  M 

a(c,T+1 


ne[l,N  ],  ie[l,N  ] 


(3.217) 


a(MB3  =  -6.  it  — 

•3/0  c*  S\N+1  S 


ne[l,N  ],  ie[l,N  ] 


(3.218) 


3(RES»)  .6  .6„At3Ltdl,At[AbJi^bl  nefl.NJ,  if[l,NJ  (3.219) 

a(MnciN-  H, 

It  is  noted  that  if  SS,  R,  Rl,  and  R2  are  negative  (i.e.,  sinks),  they  should  not  appear  in  Eqs.  (3.21 1) 
and  (3.215).  Likewise,  if  I  is  positive  (i.e,  sink),  it  must  not  appear  in  the  two  equations. 

3.4.2.  Determining  chemical  and  sediment  concentrations  at  junctions 

At  junctions,  the  following  equations  are  employed  to  determine  the  concentrations  of  chemicals  and 
sediments. 


For  suspended  sediment: 


dVYi^S  (\\  NJRTH(j) 

u)  nU)  =  £  Q kSnk  +  Mns(j)  +Mn0S(j)  +  (Rn(j) -Dn(j)] AJT(j)  ne[l,Ns]  (3.220) 

dt  k=i 


For  bed  sediment: 


3Mn(j) 


=  Dn(j)-Rn(j)  ne[l,Ns] 


(3.221) 


For  dissolved  chemical: 
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dVOCQ) 

dt 


T  Q  kC,'l-M,"'a>  -^V(i)C,w«)  ♦M,"(j>  -Mr®  +MjCOW(j) 

k=l 


(3.222) 


E  C  AJT(j)  [(Mn(j)Cfflb(j))  --^Mn(j)Ciw(j)] 

^ni 


n=l 


N„ 


+  E(^-b^)Cv(j) 

m=l 


n(cr(j)fi-4n(c;a)^ 

j=i  j=i 


For  particulate  chemical  on  suspended  sediment: 

dV(j)(Sn(j)C^(j» 

dt 


ie[l,Nc] 


NJRTH(j)  ,  D  (i) 

-  E  Q-cs.c^-M'^-^vaxs.ajc^B-^-AiToxs.d)^)) 

k=l 


(3.223) 


k*? 


Rn(i) 


^  V(j)[(Sn(j)Cn^))  -^Sn0)Ciw(j)]  +-^AJT(j)(Mna)CmD(j))  +  M‘°S( j) 

knf  Mn0) 


ne[l,Ns],  ie[l,Nc] 


For  particulate  chemical  on  bed  sediment: 

5(Mn(j)Cmb(j)) 

dt 


where 

V(j) 

AJT(j) 

Dn(j) 


y|(s„a)c^))  -^(M„o))c„b®)  -xia)M„(j)c„“a) 


(3.224) 


,  bb 
Kni 


bf 


(Mn(j)Cnb(j))-%Mna)Ciw(j) 


,  bb 
Kni 


ne[l,N  l,ie[l,N  ] 


The  volume  of  water  at  the  j-th  junction  PL3]; 

The  horizontal  area  of  the  j-th  junction  [L2]. 

Deposition  rate  of  the  n-th  size  fraction  sediment  at  the  j-th  junction  [M/L2/T]; 
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Rn(j) 

Sn(j) 

Mn(j) 

NJRTH(j) 

.0“ 

S»k 

Cwk 

p  sk 
'-'ni 

Mos0) 

M“0) 

Qw0) 

Cnib(j) 

c^O) 

M^O) 

M^O) 

Mro) 

M^O) 

Miciw(j) 

MjC0W(j) 


Erosion  rate  of  the  n-th  size  fraction  sediment  [M/L2/T]; 

Volumetrically  averaged  sediment  concentration  of  the  n-th  fraction  size  at  the  j-th  junction 
[M/L3]; 

Sediment  mass  per  unit  bed  area  of  the  n-th  size  fraction  at  the  j-th  junction  at  the  j-th 
junction  [M/L2]; 

Number  of  river/stream  reaches  which  connect  to  the  j-th  junction; 

The  flow  rate  from  the  k-th  connected  river/stream  reach  to  the  junction  [L3/T],  it  is  positive 
if  coming  in  and  negative  if  going  out; 

The  concentration  of  the  n-th  sized  suspended  sediment  from  the  k-th  connected  river/stream 
reach  to  the  junction  [M/L3] ; 

The  concentration  of  the  i-th  dissolved  chemical  from  the  k-th  connected  river/stream  reach 
to  the  junction  [M/L3] ; 

The  concentration  of  the  i-th  particulate  chemical  on  the  n-th  sized  suspended  sediment  from 
the  k-th  connected  river/stream  reach  to  the  junction  [M/L3]; 

Source  of  the  n-th  suspended  sediment  at  the  j-th  junction  [M/T]; 

Source  of  the  n-th  suspended  sediment  from  overland  flow  to  the  j-th  junction  [M/T]; 
Volometrically-averaged  concentration  of  the  i-th  dissolved  chemical  at  the  j-th  junction 
[M/L3]; 

Volometrically-averaged  particulate  chemical  concentration  on  bed  sediment  of  the  n-th 
fraction  size  at  the  j-th  junction  [M/M] ; 

Volometrically-averaged  particulate  chemical  concentration  on  suspended  sediment  of  the 
n-th  fraction  size  at  the  j-th  junction  [M/M]; 

Source  of  the  i-th  particulate  chemical  on  suspended  sediment  of  the  n-th  fraction  size  at  the 
j-th  junction  [M/T] ; 

Source  of  the  i-th  particulate  chemical  on  suspended  sediment  of  the  n-th  fraction  size  from 
overland  to  the  j-th  junction  [M/T]; 

Source  of  the  i-th  dissolved  chemical  at  the  j-th  junction  [M/T]; 

Rainfall  source  of  the  i-th  dissolved  chemical  at  the  j-th  junction  [M/T]; 

Infiltration  sink  of  the  i-th  dissolved  chemical  at  the  j-th  junction  [M/T]; 

Source  of  the  i-th  dissolved  chemical  from  overland  to  the  j-th  junction  [M/T]. 


Eqs.  (3.220)  and  (3.221)  are  solved  first  by  using  the  Picard  method,  while  Eqs.  (3.222)  through 
(3.224)  are  solved  with  the  Newton-Raphson  method. 


3.4.3.  Estimation  of  Deposition  and  Erosion 

We  estimate  the  deposition  and  erosion  rates  by  using  the  following  equations. 


<  Case  1  >  Cohesive  sediments:  (e.g.,  silt  and  clay) 


D„  =  VsnSn  1- 


(3.225) 


(3.226) 


where  Vsn  is  the  settling  velocity  of  the  n-th  size  fraction  sediment  [L/T] ;  xb  is  the  bottom  shear  stress  or  the 
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bottom  friction  stress  [M/L/T2];  xcDn  is  the  critical  shear  stress  for  the  deposition  of  the  n-th  size  fraction 
sediment  [M/L/T2];  xcRn  is  the  critical  shear  stress  for  the  erosion  of  the  n-th  size  fraction  sediment  [M/L/T  ]; 
En  is  the  erodibility  of  the  n-th  size  fraction  sediment  [M/L2].  In  the  computer  code,  Vm,  xcDn,  TcRn,  and  En 
are  input  parameters,  while  xb  is  computed  in  the  flow  module. 

<  Case  2  >  Non-cohesive  sediments:  (e.g.,  sand) 

D  =  GsAn  ~Gsn  (3.227) 

“  AL 


r  =  °sn  °sAn  (3.228) 

D  AL 

where  GsAn  is  the  actual  load  rate  of  the  n-th  size  fraction  sediment  per  unit  width  at  a  upstream  location 
[M/L/T];  Gsn  is  the  maximum  load  rate  (capacity)  of  the  n-th  size  fraction  sediment  per  unit  width  at  a 
downstream  location  [M/L/T];  AL  is  the  distance  between  the  upstream  and  the  downstream  locations.  In 
the  computer  code,  AL  can  be  determined  based  on  the  coordinates,  while  GsAn  and  Gsn  are  computed  based 
on  the  following  equations. 

GsAn  =  Sn*u*r  (3.229) 


G  =  10  - — — —  (3.230) 

gdn(Psn-p)2 

where  p  is  the  fluid  density  [M/L3];  psn  is  the  density  of  the  n-th  size  fraction  sediment  [M/L  ],  u  is 
river/stream  flow  velocity  [L/T];  r  is  hydraulic  radius  [L];  S  the  friction  slope,  dn  is  the  median  diameter  of 
the  n-th  size  fraction  sediment  particle  [L];  g  is  gravity  [L/T2];  xcrn  is  the  critical  bottom  shear  stress  of  the 
n-th  size  fraction  sediment  at  which  sediment  movement  begins  [M/L/T2].  Among  these  parameters,  p,  psn, 
d„,  and  xcrn  are  input  by  users,  while  u,  r,  and  S  are  estimated  in  the  flow  module. 

Note:  Eq.  (3.230)  is  from  “Hydraulics  of  Sediment  Transport"  by  Walter  Hans  Graf  (1984),  Water 

Resources  Publication,  Eq.  (7.14)  on  page  128.  Eqs.  (3.225)  through  (3.228)  can  befoundfrom 
“CHNTRN:  A  Channel  Transport  Model  for  Simulating  Sediment  and  Chemical  Distribution 
in  a  Stream/River  Network"  by  Yeh  (1983),  ORNL-5882  Report,  Eqs.  (29)  and  (30)  on  page  12. 


3.5.  Solving  the  2-D  overland  transport  equations 

The  strategy  for  solving  2-D  overland  transport  equations  has  been  described  in  the  previous 
section  and  will  not  be  repeated  here.  In  the  following,  we  are  to  go  through  the  procedures  of  solving  the 
2-Dtransport  system,  like  what  we  have  achieved  in  Section3.3.1  for  1 -Driver/stream  transport.  Recall  Eqs. 
(2.53)  through  (2.57)  and  express  them  in  the  Lagrangian  form  for  mobile  materials  as  follows. 

For  the  continuity  equation  of  suspended  sediment: 

ds  as 

h— A  =  h— ^+q-VSn  =  0  (3.231) 

dt  at 
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h— -V-fhK-VSl  =  [Mns+Rn-Dn]-[SS+R-l]Sn  ne[l,Ns]  (3.232) 

dt  L  J  L 


For  the  continuity  equation  of  bed  sediment: 


r=Dn"Rn 


(3.233) 


For  the  continuity  equation  of  dissolved  chemical: 


dQ  dC * 

h — -  =  h — —  +q-VCj  =  0 
dt  & 


(3.234) 


dCj  r  wl 

h — — -V*  hK-VC: 
dt  L  J 


-  E  (a^-b^)k^h  ft  (Cj’)bi-4n  (Cj")* 

m=l  J’1  J'l 


*  *ECh(S.O* £  C(M„0 

n=l  n=l 


X[h+hk?  +  £  Snhknf  +  E  Mnk^f  +  SS  +R-I  C;w  ie[l,Nc] 


(3.235) 


For  the  continuity  equation  of  particulate  chemical  on  suspended  sediment: 

hd^  _  h£(S^  =  o 

dt  at 


(3.236) 


d(S  Cn-)  r  s  I 

h  "  —  -V-  hK-V(SnCni) 

dt  L  J 


MT*y'hS.C1’*i(M,C*-^(S.O  -[jib+k*h*SStR-l](S„0 


(3.237) 


ne[l,N  1,  ie[l,N  ] 


For  the  continuity  equation  of  particulate  chemical  on  bed  sediment: 


(3.238) 


ne[l,N  ],ie[l,N  ] 
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We  solve  the  transport  system  by  achieving  the  following  steps. 

Step  1  Solve  Eqs.  (3.231),  (3.234),  and  (3.236)  to  obtain  the  Lagrangian  values  for  suspended 
sediments,  dissolved  chemicals,  and  particulate  chemicals  on  suspend  sediments. 

Step  2  Solve  Eqs.  (3.232)  and  (3.233)  for  Sn  and  Mn. 

(a)  Solve  Eq.  (3.232)  with  all  source/sink  terms  evaluated  at  the  previous  time,  as  described  in  Eq.  (3.184). 
(the  predictor  process  of  Eq.  (3.232)) 

==>  Obtaining  the  intermediate  value  for  suspended  sediments. 

(b)  Prepare  the  corrector  form  of  Eqs.  (3.232)  as  described  in  Eq.  (3.186).  It  can  be  written  as  follows. 

.  (Sn)N+1-(Sn)N+1/2 

h - 6t - 

=  (RHSns)N+1-(RHSns)N  (if(RHSns)N*0)  (3.239) 

=  (RHSns)N+1-(RHS—  (S„)N*1/2  (if  (RHSns)N<0)  ne[l,Ns] 

(Sn)N 

where 

(RHSns)  =  [Mns+Rn-Dn]-[SS+R-l]Sn  ne[l,Ns]  (3.240) 

(c)  Solve  Eq.  (3.239)  and  Eq.  (3.233)  node  by  node  with  the  Picard  method  to  obtain  the  solutions  for 
suspended  and  bed  sediments. 

Note:  In  Eqs.  (3.232)  and  (3.233)  both  Dn  and  Rn  need  to  be  evaluated  first,  while  in  Eq.  (3.232)  K, 

h,  R,  I,  and  SS  are  either  given  or  determined  after  the  flow  equations  are  solved.  During  each 
iteration  in  (c),  both  Eq.  (3.239)  and  (3.233)  are  solved  with  the  time-implicit  scheme. 

Step  3  Solve  Eqs.  (3.235),  (3.237),  and  (3.238)  for  C*,  C*',  and  Cj>. 

(a)  Solve  Eqs.  (3.235)  and  (3.237)  with  all  source/sink  terms  evaluated  at  the  previous  time,  as  described  in 
Eq.  (3.184).  (the  predictor  process  of  Eqs.  (3.235)  and  (3.237)). 

(b)  Prepare  the  corrector  form  of  Eqs.  (3.235)  and  (3.237)  described  in  Eq.  (3.186).  They  can  be  written  as 
follows. 

For  dissolved  chemicals: 
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(Ciw)N+1-(Ciw)N+1/2 


where 


=  (RHSjC)n+1 -(RHSiC)N  (if  (RHSjC)N^o) 

=  (RHS  C)N1  -  (RHSi  —  (C/T+172  (if  (RHSic)N<o) 

(Cf 


ie  [1,N  ] 


(3.241) 


c  krf  N‘ 
bml  Km  TT 


(rhs,c)  =  e  (^-^)Ci>n<cJT--^n<cjw) 

m-1  H  k„  i-1 


+  M-  +hkfPi+Ek>(SnC-)  +E  C(MnCmb)  +MT  -M r 1 


(3.242) 


;L‘h+hk^  +  £Snhk^£MnCf  +  SS+R-I  c"  ie[l,Nc] 


For  particulate  chemicals  on  suspended  sediments: 

/  o  S\N  +  1  /  c  p  s\N  +  l/2 

,  Wn^ni/ 


where 


=  (RHS^)n+1-(RHS^)n  (if(RHS,*)N*o) 


(3.243) 


=  (RHS„i)Ntl  -  (RHS-- (C^)NM/2  (if  (RHSnSj)N<o)  ne[l,N$],  ie[l,Nc] 

(On 


(RHS^)  =  M“  -ChS^r  +  -^(M„Cmb)  -^(SnO 


(3.244) 


-  ^h+k*h+SS+R-l](SnO  ne[l,Ns],  ie[l,Nc] 

(c)  Solve  Eqs.  (3.241),  (3.243),  and  (3.238)  node  by  node  with  the  Newton-Raphson  method. 

Note:  In  Eqs.  (3.235),  (3.237),  and  (3.238)  Sn  and  M„  are  computed  in  Step  1,  while  h,  K,  reaction  rate 

constants,  stoichiometry,  1-st  order  decay  constants,  partial  atmospheric  pressure,  and 
sources/sinks  are  either  given  or  determined  after  the  flow  equations  are  solved. 

To  achieve  the  (c)  of  Step  3,  the  following  residual  equations  are  constructed 


Sec3-36 


For  dissolved  chemicals: 


(RESjC) 


h[(CjW)N+1  -(CiT+ua]-6t[(RHSic)N*1  -(RHS;C)Nj  (if  (RHSjC)N^o) 
h[(CjW)N+1  -(CjW)N+1/2]-6t  (RHS;c)n+1  -  (^N  (C*)"'112  (if  (RHSjC)N<o) 


(3.245) 


i  e  [  1  ,N  ] 


For  particulate  chemicals  on  suspended  sediments: 
(RES,') 


l'[(S1,C1‘)N'1  -(S„C,‘)N*in]-6t[(RHS1’)'M -(RHS,*)"]  (if (RHS^iO) 


=  h[(S,0N*'-<SnC^)N-'2l-6t  (RHS^)N- - (RHS|J>  (S,C^r'°  (if  (RHS„’)N<oj 
1  J  <SnON 


(3.246) 


ne[l,N  ],  i e [  1  ,N  ] 


For  particulate  chemicals  on  bed  sediments: 


(RES  b)  =  (MnCmb)N+1-(MnC,J)N-At(RHSni)N+1  ne[l,Ns],  ie[l,Nc]  (3.247) 
The  associated  Jacobian  elements  are  thus  computed  as  shown  in  the  following. 


For  dissolved  chemicals: 
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For  particulate  chemicals  on  suspended  sediments: 

a(RESj)  =  fitkrfs  h  ne[l,Ns],  ie[l,Nc]  (3.251) 

6(C,w)n+1 


8(RES^-  =  6ah  +&a  6t  —  +6a  8t  f^h  +k^,bh  +SS  +R  -ij 
5(SnC^)N+1  Sn 


(3.252) 
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(3.253) 


For  particulate  chemicals  on  bed  sediments: 
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8(RES.nl L  =  6a  +  6U At  —  +  6a At +  kbb ]  ne[l,Nt],  ie[l,Nc]  (3.256) 
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It  is  noted  that  if  SS,  and  R  are  negative  (i.e.,  sinks),  they  should  not  appear  in  Eqs.  (3.248)  and 
(3.252).  Likewise,  if  I  is  positive  (i.e,  sink),  it  must  not  appear  in  the  two  equations. 


3.6.  Solving  the  3-D  subsurface  transport  equations 

The  strategy  for  solving  3-D  subsurface  transport  equations  is  similar  to  that  used  to  solve  1-D 
and  2-D  transport  equations:  using  the  predictor-corrector  method  to  handle  mobile  materials  (the  dissolved 
chemicals  in  this  case)  and  solve  the  ordinary  differential  equations  of  chemical  reactions  in  the  corrector 
process.  In  the  following,  we  are  to  go  through  the  procedures  of  solving  the  3-D  transport  system.  Recall 
Eqs.  (2.63)  through  (2.65)  and  express  them  in  the  Lagrangian  form  for  mobile  materials  as  follows. 

(1)  For  dissolved  chemicals: 

dC:  dC:  w  ('X 

0 _ L_  =  e — !_+V-VC:  =  0  (3.257) 

dt  3t 
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ace  sp 
at 

(3.259) 

je[l,Ns] 

(3)  For  adsorbed  chemical: 

3(0^) 

at 

(3.260) 
je[l,Nd] 

We  solve  the  transport  system  by  achieving  the  following  steps. 

Step  1  Solve  Eq.  (3.257)  to  obtain  the  Lagrangian  values  for  dissolved  chemicals. 

Step  2  Solve  Eqs.  (3.258),  (3.259),  and  (3.260)  for  Cf,  Sj(  and  Dj. 

(a)  Solve  Eq.  (3.258)  with  all  source/sink  terms  evaluated  at  the  previous  time,  as  described  in  Eq.  (3.184). 
(the  predictor  process  of  Eq.  (3.258)). 
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(b)  Prepare  the  corrector  form  of  Eqs.  (3.258)  as  described  in  Eq.  (3.186).  It  can  be  written  as  follows. 


For  dissolved  chemicals: 
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(c)  Solve  Eqs.  (3.259),  (3.260),  and  (3.261)  node  by  node  with  the  Newton-Raphson  method. 

Note:  In  Eqs.  (3.258),  (3.259),  and  (3.260)  6,  D,  reaction  rate  constants,  stoichiometry,  1-st  order 

decay  constants,  and  sources/sinks  are  either  given  or  determined  after  the  flow  equations  are 
solved. 


To  achieve  the  (c)  of  Step  2,  the  following  residual  equations  are  constructed. 


For  dissolved  chemicals: 
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For  adsorbing  sites: 

(RESjS)  =  (0  Sj)N+1  -(0  SpN  -  At  (RHSjS)N+1  je[l,Ns]  (3.264) 

in  which 
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For  adsorbed  chemicals: 
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The  associated  Jacobian  elements  are  thus  computed  as  shown  in  the  following. 
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For  dissolved  chemicals: 
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For  adsorbing  sites: 
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For  adsorbed  chemicals: 
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It  is  noted  that  if  q  is  negative  (i.e.,  sink),  it  should  not  appear  in  Eq.  (3.268). 
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Section  4.  EXAMPLES 


In  this  section,  we  apply  the  model  to  perform  fifteen  simulations,  including  1-D  flow,  1-D  transport, 
1-D  flow  and  transport,  2-D  flow,  2-D  transport,  2-D  flow  and  transport,  3-D  flow,  3-D  transport,  3-D  flow 
and  transport,  1-D/2-D  flow,  2-D/3-D  flow,  1-D/2-D/3-D  flow,  1-D/2-D  flow  and  transport,  2-D/3-D  flow 
and  transport,  and  1-D/2-D/3-D  flow  and  transport.  Unless  specifically  announced,  the  diffusion  wave  model 
is  solved  when  the  simulation  of  water  flow  is  involved  in  those  examples. 


4.1.  Examples  of  1-D  river/stream  flow 

4.1.1.  Example  1  of  1-D  river/stream  flow 

In  this  example,  a  horizontally  200  m-long  river/stream  containing  a  uniform  width  of  2  m  is 
considered.  The  bottom  elevation  of  the  river/stream  is  shown  in  Figure  4.1.  Manning’s  roughness  is  0.015. 
Initially,  it  is  dry  everywhere.  As  the  simulation  starts,  a  uniform  rainfall  of  1  O'5  m/s  covers  the  entire  domain 
of  interest.  At  the  upstream  boundary  node  (i.e.,  X  =  0  m)  water  depth  is  set  at  1010  m,  while  at  the 
downstream  boundary  node  (i.e.,  X  =  200  m)  a  water  depth-dependent  flow  rate  boundary  condition  is 
applied.  No  infiltration  is  considered  in  this  example.  The  domain  is  discretized  with  twenty  elements,  10 
m  long  for  each.  A  one-hour  simulation  is  performed  with  a  fixed  time  step  size  of  2  seconds.  A  relative 
error  of  10"4  is  used  to  determine  convergence  for  the  nonlinear  loop. 

Figures  4.2  and  4.3  plot  water  depth  and  discharge,  respectively,  at  time  =  100  s,  200  s,  300  s,  600 
s,  and  1200  s.  Since  the  change  of  water  depth  is  almost  unobservable  after  time  =  1200  s,  a  steady  state  is 
presumed  to  have  reached  thereafter  under  a  uniform  rainfall  of  10  5  m/s.  From  Figure  4.2,  a  hydraulic  jump 
is  observed  from  X  =  50  m  to  X  =  60  m  due  to  the  slope  change  from  -0.2  to  -  0.00 1 .  In  each  constant  slope 
region  (i.e.,  X  =  0  to  50  m,  X  =  50  to  150  m,  and  X  =  150  to  200  m),  water  depth  has  the  tendency  to  increase 
gradually  along  the  downslope  direction  because  of  a  constant  rainfall  over  the  entire  domain.  We  can  also 
observe  backwater  effect  in  the  region  close  to  the  downstream  outlet  (X  =  170  to  200  m).  In  Figure  4.3, 
Discharge  is  computed  by  multiplying  flow  velocity  with  cross-sectional  area  which  is  water  depth- 
dependent.  In  comparison  of  Figures  4.2  and  4.3,  it  is  seen  that  the  flow  velocities  within  X  £  [150, 200]  are 
large  enough  to  make  the  discharge  pattern  different  from  the  water  depth  pattern,  which  is  due  mainly  to 
the  0.1  slope  associated  with  this  region. 


4.1.2.  Example  2  of  1-D  river/stream  flow 

This  example  simulates  water  flow  in  a  river/stream  network  system.  The  system  is  composed  of 
three  river/stream  reaches  that  are  connected  through  a  junction  (Figure  4.4).  Each  reach  is  100  m  long  and 
is  discretized  with  1 1  nodes  and  10  elements:  Nodes  1  through  1 1  for  Reach  1,  12  through  22  for  Reach  2, 
and  23  through  33  for  Reach  3.  Nodes  11,  12,  and  33  coincide  with  one  another  and  are  located  at  the 
junction.  The  junction  covers  the  area  between  Nodes  10  and  1 1,  Nodes  12  and  13,  and  Nodes  32  and  33. 

Reaches  1  and  3  have  a  uniform  river/stream  width  of  2  m  and  the  slope  of  their  bottom  elevation 
is  -0.2  along  the  downstream  direction,  while  Reach  2  contains  a  uniform  river/stream  width  of  3  m  and  the 
slope  of  its  bottom  elevation  is  -0.1.  Manning’s  roughness  is  0.02  for  all  three  reaches.  Initially,  it  is  dry 
everywhere.  As  the  simulation  starts,  a  uniform  rainfall  of  1 0'5  m/s  is  put  on  Reach  1 .  At  Node  1  water  depth 
is  kept  at  0  m,  while  a  constant  flow  of  2X10"4  m3/s  flows  through  Node  23  through  the  simulation  and  a  water 
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depth-dependent  flow  rate  boundary  condition  is  applied  at  the  downstream  boundary  node  (i.e.,  Node  22). 
No  infiltration  is  considered  in  this  example.  A  one-hour  simulation  is  performed  with  a  fixed  time  step  size 
of  2  seconds.  A  relative  error  of  10"*  is  used  to  determine  convergence  for  the  nonlinear  loop. 

Figures  4.5  through  4.7  plots  water  depth  at  various  times  for  Reaches  1  through  3,  respectively. 
Since  rainfall  and  upstream  boundary  conditions  do  not  vary  with  time,  a  steady  state  is  observed  after  time 
=  600  s.  It  is  noted  that  the  downstream  node  of  Reach  1  (i.e.,  at  X  =  100  m  in  Figure  4.5),  the  upstream  node 
of  Reach  2  (i.e.,  at  X  =  0  m  in  Figure  4.6)  and  the  downstream  node  of  Reach  3  (i.e.,  at  X  =  100  m  in  Figure 
4.7)  coincide  with  one  another  and  are  where  the  junction  is.  One  can  verify  this  by  checking  the  water 
depths  at  these  locations.  We  can  see  the  marching  of  wet  fronts  in  both  Figures  4.6  and  4.7  and  an 
increasing  depth  along  the  downstream  direction  in  Figure  4.5  due  to  a  constant  uniform  rainfall. 


42.  Example  of  2-D  overland  flow 

We  give  two  examples  in  this  subsection.  Example  1  is  to  show  the  application  of  using  the 
diffusion  wave  model  to  handle  an  overland  system  which  contains  the  slope  of  bottom  elevation  ranging 
from  0.01  to  0.5;  Because  of  the  steep  slope  involved,  the  dynamic  model  is  difficult  to  solve  with  any 
numerical  scheme,  even  with  the  most  physically  natural  method  of  characteristics.  Example  2  is  a  standing 
wave  problem  to  demonstrate  the  capability  of  the  method  of  characteristics  to  accurately  solve  the  dynamic 
wave  model  when  the  slope  is  small.  Difficulty  is  encountered  in  dealing  with  water  flow  over  steep  slope 
overland  system  by  solving  the  dynamic  wave  model.  On  the  other  hand,  the  diffusion  wave  model  cannot 
provide  accurate  solution  when  the  inertia  terms  are  important,  such  as  flow  on  a  flat  region.  Thus,  it  is 
desirable  to  develop  a  hybrid  model  in  which  an  adaptive  scheme  can  be  built  to  automatically  select 
appropriate  models  (kinematic,  diffusion,  or  dynamic  wave  models)  for  different  regions  of  the  entire 
watershed. 

4.2.1.  Example  1  of  2-D  overland  flow 

The  domain  of  interest  coveres  a  horizontal  area  of  200  m  X  80  m.  The  bottom  elevation  contour  is 
given  in  Figure  4.8.  The  domain  is  discretized  with  320  triangular  elements  (Figure  4.9).  Manning  s 
roughness  is  0.04.  Initially,  it  is  dry  everywhere.  A  two-hour  simulation  is  performed  with  a  fixed  time  step 
size  of  5  seconds.  A  relative  error  of  10"*  is  used  to  determine  convergence  for  the  nonlinear  loop.  As  the 
simulation  starts,  a  uniform  rainfall  of  10"5  m/s  covers  the  entire  domain  of  interest  for  the  first  half  hour  and 
1 .5x1 0'5  m/s  for  the  third  half  hour.  As  for  the  second  and  the  fourth  half  hours,  the  rainfall  rate  is  zero.  On 
the  upstream  boundary  side  (i.e.,  X  =  0  m)  water  depth  is  set  at  10 10  m  through  the  simulation,  while  on  the 
downstream  boundary  side  (i.e.,  X  =  200  m)  a  water  depth-dependent  flux  boundary  condition  is  applied. 
The  boundaries  of  Y  =  0  m  and  80  m  are  impermeable.  No  infiltration  is  considered  in  this  example. 

Figure  4.10  plots  water  depth  at  various  times  from  the  simulation.  From  the  figure,  we  can  first  see 
the  irregular  depth  distribution  due  to  the  slope  change  of  ground  surface  (Figure  4.8).  Since  the  water 
depths  at  Time  =  600  s,  1200  s,  and  1800  s  can  not  be  distinguished,  we  may  say  a  steady  state  has  reached 
by  Time  =  600  s  under  a  rainfall  of  10'5  m/s.  Likewise,  the  depths  at  the  end  of  the  second  and  the  fourth  half 
hours  (i.e..  Time  =  3600  s  and  7200  s,  respectively)  tells  us  the  steady  state  for  the  two  non-rainfall  period 
of  times  have  reached  by  then. 

4.2.2.  Example  2  of  2-D  overland  flow 
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A  1-D  standing  wave  problem  is  considered  in  this  example.  It  is  solved  by  2-D  method  of 
characteristics,  as  presented  in  Section  3.2.1.  This  problem  is  governed  by  the  wave  equations  as  follows. 
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where  u  is  the  velocity  along  the  1-D  direction  [L/T];  c  is  the  wave  speed  [L/T];  h  is  water  depth  [L];  T|  is 
stage  deviation  [L];  g  is  gravity  [L/T2].  The  domain  of  interest  is  200  m  long  in  the  x-direction  and  50  m 
wide  in  the  y-direction.  It  is  discretized  with  20  elements:  10  m  x  50  m  each.  The  boundary  end  of  X  =  200 
m  is  closed,  while  the  other  one  at  X  =  0  m  is  open  and  the  water  stage  is  forced  up  and  down  according  to 
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Thus,  we  set  u  =  0  m/s  at  X  =  200  m  to  settle  the  boundary  condition  for  achieving  the  simulation. 
The  analytical  solution  of  this  problem  can  be  found  as  follows  [Wang  and  Connor,  1975]. 
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A  simulation  of  400  seconds  is  performed,  where  time  step  size  is  set  to  2.5  seconds.  The  initial 
condition  is  given  at  t  =  50  s  according  to  Eqs.  (4.5)  and  (4.6).  Figures  4.1 1  and  4.12  show  the  comparison 
of  water  depth  and  velocity,  respectively,  between  analytical  solution  and  computed  results  at  various  times. 
The  comparison  simply  tells  that  the  method  of  characteristics  can  solve  the  dynamic  wave  model  quite 
accurately. 


4.3.  Example  of  1-D  river/stream  transport 

This  example  is  to  demonstrate  the  capability  of  the  model  in  simulating  both  chemical  and  sediment 
transport.  A  horizontally  200  m-long  river/stream  containing  a  uniform  width  of  2  m  is  considered.  To  focus 
on  transport,  we  assume  water  depth  is  2  m  and  river/stream  velocity  is  1  m/s  throughout  the  river/stream. 
Three  dissolved  chemicals  are  considered  to  undergo  the  following  reaction. 

Cl  +  C2  *  C3  kf  =  0.002,  kb  =  0.005  (4.7) 

where  Cl  ,  C2  ,  and  C3  represent  dissolved  chemicals. 
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Three  sizes  of  sediments  are  taken  into  account  and  are  considered  to  be  cohesive  sediments.  The 
settling  speeds  are  1 .2X106  m/s  for  Sediment  1, 1.5X10"4  m/s  for  Sediment  2,  and  4.5x10  m/s  for  Sediment 
3.  The  critical  shear  stresses  for  deposition  and  erosion  are  2.75  g/m/s2  and  2.68  g/m/s2,  respectively,  for  all 
three  sediments.  The  following  sorption  reactions  are  included. 
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CC  +  SS2  **  PS2 
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CC  +  BSl  **  pbT 

+  BSl 

kf  =  0.0001, 

kb  =  0.0 

(4.11) 

CC  +  BS2  **  PB2 

+  BS2 

kf  =  0.0001, 

kb  =  0.0 

(4.12) 

CC  +  BS3  **  PB3 

+  BS3 

kf  =  0.0001, 

kb  =  0.0 

(4.13) 

where  CC  can  be  Cl  ,  C2  ,  or  C3  ;  SSI  ,  SS2  ,  and_  SS3  are  suspended  sediments;  BS1  , 
BS2  ,  and  BS3  are  bed  sediments;  PS1  ,  PS2  ,  and  PS3  are  particulate  chemicals  on  suspended 
sediments  associated  with  CC  ;  PB1  ,  PB2  ,  and  PB3  are  particulate  chemicals  on  bed  sediments 
associated  with  CC  .  We  have,  therefore,  18  sorption  reactions  in  total. 

Initially,  only  bed  sediments  exist  in  the  domain  of  interest.  The  initial  concentration  is  50  g/m3  for 
the  first  bed  sediment,  75  g/m3  for  the  second,  and  100  g/m3  for  the  third.  As  the  simulation  starts,  Dirichlet 
boundary  conditions  are  applied  to  the  upstream  boundary  node  (i.e.,  X  =  0  m),  where  all  dissolved  chemicals 
have  a  constant  concentration  of  1  g/m3  and  all  other  mobile  materials  have  zero  concentration  at  this 
boundary  node.  The  longitudinal  dispersivity  is  0.01  m.  A  1000  second  simulation  is  performed  with  afixed 
time  step  size  of  2  seconds.  A  relative  error  of  10"*  is  used  to  determine  convergence  for  both  linear  and 
nonlinear  iterations  involved  in  the  computation. 

Figures  4.13  through  4.17  plot  the  numerical  results  at  various  time,  including  concentration 
distributions  for  (1)  dissolved  chemicals  (Figure  4.13),  (2)  suspended  sediments  (Figure  4.14),  (3)  bed 
sediments  (Figure  4.15),  (4)  particulate  chemicals  on  suspended  sediments  (Figure  4.16),  and  (5)  particulate 
chemicals  on  bed  sediments  (Figure  4.17).  Since  the  first  and  second  dissolved  chemicals  are  involved  in 
identical  reactions,  their  concentration  distributions  are  identical  to  each  other,  so  do  those  of  their  related 
particulate  chemicals. 

Figure  4. 13  shows  a  decreasing  dissolved  chemical  concentration  for  all  three  dissolved  chemicals. 
This  is  because  we  allow  the  adsorption  to  happen,  but  do  not  allow  desorption  from  particulate  chemicals 
to  dissolved  chemicals  (see  Eqs.  (4.8)  through  (4.13)).  Figure  4.14  shows  the  trend  of  increasing 
concentration  of  suspended  sediment  along  the  downstream  direction,  while  Figure  4.15  depict  the  decrease 
of  bed  sediment  with  the  increase  of  time.  Figures  4.14  and  4.15  tell  that  the  deposition  is  less  than  the 
erosion  under  the  condition  set  for  this  example.  Figures  4.16  and  4.17  also  help  verify  this.  Since  the 
dissolved  chemicals  are  little  in  the  downstream  region,  the  major  source  of  chemicals  are  the  particulate 
chemicals  on  suspended  sediments  that  are  transported  from  the  upstream  region  along  with  water.  Because 
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erosion  is  greater  than  deposition,  we  can  hardly  find  particulate  chemicals  on  bed  sediments  in  the 
downstream  region  (Figure  4.17).  On  the  other  hand,  we  observe  an  increase  of  particulate  chemical  on 
suspended  sediments  along  the  downstream  direction  (Figure  4.16).  By  comparing  the  numerical  results  at 
various  times,  it  seems  that  the  concentration  distributions  (Figures  4.13, 4.14,  and  4.16)  are  approaching  a 
steady  state.  This  tendency  will  continue  until  the  bed  sediments  are  completely  depleted,  starting  from  the 
upstream  end. 


4.4.  Example  of  2-D  overland  transport 


The  domain  of  interest  has  covered  a  horizontal  area  of  200  m  x  70  m  and  is  discretized  with  140 
rectangular  elements:  10  m  x  10  m  for  each  element.  To  deal  with  transport  only,  water  depth  is  set  to  1  m 
and  the  velocity  is  -1.0  m/s  in  the  x-direction  and  0.0  m/s  in  the  y-direction  everywhere.  The  following 
chemical  reactions  are  embraced. 


cl  +  C2  -  C4 
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o 

kb  =  0.005 

(4.14) 

Cl  +  C3  -  C5 

kf  =  0.01, 

kb  =  0.0025 

(4.15) 

C2  +  2C3  **  C6 

kf  =  0.01, 

kb  =  0.001 

(4.16) 

where  Cl  ,  C2  ,  C3  ,  C4  ,  C5  ,  and  C6  are  dissolved  chemicals. 


Initially,  there  is  no  dissolved  chemical  anywhere  in  the  domain.  A  600  second  simulation  is 
performed  with  a  fixed  time  step  size  of  10  seconds.  A  relative  error  of  10*4  is  used  to  determine 
convergence  for  the  nonlinear  loop.  As  the  simulation  starts,  a  Dirichlet  concentration  of  1  g/m3  is  applied 
for  Cl  ,  C2  ,and  C3  on  the  upstream  boundary  (i.e.,  X  =  200  m)  between  Y  =  30  m  and  40  m.  The 
boundaries  of  Y  =  0  m  and  70  m  are  impervious.  The  longitudinal  and  transverse  dispersivities  are  0.5  m 
and  0.1  m,  respectively.  The  diffusion  coefficient  is  10‘5  m2/s. 

Figures  4.18  through  4.23  show  the  numerical  result  at  time  =_260  s^A  steady  state  result  is 
considered  to  have  reached  after  260  s.  The  maximum  concentrations  of  C4  ,  C5  ,  and  C6  are  0.26286 
g/m3, 0.25637  g/m3,  and  0. 16833  g/m3,  respectively,  which  are  found  in  the  middle  of  downstream  area  (i.e., 
X  =  40  to  50  m  and  Y  =  30  to  40  m) 


4.5.  Example  of  1-D  river/stream  flow  and  transport 

In  this  example,  a  horizontally  200  m-long  river/stream  containing  a  uniform  width  of  2  m  is 
considered.  The  bottom  elevation  of  the  river/stream  is  shown  in  Figure  4.1.  Manning’ s  roughness  is  0.0 1 5 . 
Initially,  it  is  dry  everywhere.  The  chemical  reactions  considered  are  identical  to  those  in  the  example  of  2-D 
transport  (Eqs.  (4.14)  through  (4.16)).  As  the  simulation  starts,  a  uniform  rainfall  of  10 5  m/s  covers  the 
entire  domain  of  interest,  which  contains  the  first  three  chemicals  (i.e.,  Cl  ,  C2  ,  and  C3  )  of  1  g/m3. 
At  the  upstream  boundary  node  (i.e.,  X  =  0  m)  water depth  is  kept  at  10 10  m  and  the  concentrations  are  kept 
at  1  g/m3  for  Cl  ,  C2  ,  C3  and  at  0  g/m3  for  C4  ,  C5  ,  C6  .  At  the  downstream  boundary  node 
(i.e.,  X  =  200  m)  a  water  depth-dependent  flow  rate  boundary  condition  is  employed  for  flow  and  a  variable 
boundary  condition  is  applied  for  transport.  Infiltration  is  neglected.  The  domain  is  discretized  with  twenty 
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elements,  10  m  long  for  each.  A  one-hour  simulation  is  performed  with  a  fixed  time  step  size  of  2  seconds. 
A  relative  error  of  10*4  is  used  to  determine  convergence  for  required  iteration  in  both  flow  and  transport 
computations. 

Figure  4.24  depicts  water  depth  at  various  times  for  the  simulation.  It  is  the  same  as  Figure  4.2 
because  they  have  an  identical  setup  for  the  flow  simulation  and  we  assume  the  flow  is  not  influenced  by 
transport  in  the  model.  Figures  4.25  through  4.31  show  the  concentration  distributions  at  various  times  for 
the  first  through  the  sixth  dissolved  chemicals,  respectively.  It  is  seen  that  the  third  dissolved  chemicals  are 
consumed  most  among  the  three  reactant  chemicals  that  consumes  most  in  this  example  (Figures  4.25  through 
4.27).  This  is  because  all  three  reactions  contain  the  same  forward  reaction  rate  constant  (Eqs.  (4. 16)  through 
(4.18))  but  the  third  reaction  has  the  smallest  backward  reaction  rate  constant  and  the  third  dissolved 
chemical  has  a  stoichiometric  coefficient  of  2  as  a  reactant  chemical  in  the  third  reaction  (Eq.  (4.16)). 


4.6.  Example  of  2-D  overland  flow  and  transport 

The  setup  for  the  flow  simulation  in  this  example  is  the  same  as  that  in  the  example  of  2-D  flow 
(Section  4.2)  except  that  time  step  size  is  2.5  s  for  this  example.  The  same  chemical  system  as  described  in 
both  Sections  4.4  and  4.5  is  also  considered  here.  Initially,  it  is  dry  and  there  is  no  chemical  in  the  domain 
of  interest.  As  the  simulations  starts,  Dirichlet  boundary  conditions  are  applied  on  the  upstream  boundary 
(i.e.,  X  =  0  m)  for  the  transport  simulation,  where  the  concentrations  of  Cl  ,  C2  ,  C3  are  maintained 
at  1  g/m3  and  those  of  C4  ,  C5  ,  C6  are  at  0  g/m3. 

Figures  4.31  through  4.37  plot  the  numerical  results  at  various  times.  Figure  4.31  is  actually 
representing  the  same  computational  result  as  Figure  4.10  for  Example  1  of  2-D  overland  flow  in  Section 
4.2.1.  This  is  again  because  this  example  has  a  simulation  setup  identical  to  that  of  the  example  in  Section 
4.2.1  and  the  feedback  from  transport  to  flow  is  not  considered  in  the  model.  Although  the  results  shown 
in  Figures  4.32  through  4.37  are  difficult  to  analyze,  we  can  observe  the  same  concentration  distribution 
trends  from  upstream  to  downstream  for  the  six  dissolved  chemicals  as  those  shown  in  Figures  4.25  through 
4.30.  Additionally,  it  is  consistent  that  C3  and  C6  are  the  chemicals  having  the  smallest  concentration 
among  the  three  reactant  chemicals  and  the  three  product  chemicals,  respectively,  in  the  downstream  region. 


4.7.  Example  of  1-D/2-D  flow 

A  flow  system  including  both  1-D  river/stream  and  2-D  overland  is  considered  in  this  section.  The 
topography  and  discretization  of  the  system  is  plotted  in  Figure  4.38.  As  shown  in  the  figure,  water  would 
flow  from  overland  into  the  river/stream  that  is  located  in  the  middle  of  the  system  (i.e.,  the  blue  strip)  and 
then  leave  the  system  through  the  downstream  outlet  of  the  river/stream  (i.e.,  at  X  =  0  m,  Y  =  0  m).  The 
slope  of  river/stream  bottom  elevation  is  0.02. 

The  river/stream  width  increases  along  river/stream’s  downstream  direction:  10  m  at  Y  =  100  and 
90  m,  12  m  at  Y  =  80  and  70  m,  14  m  at  Y  =  60  and  50  m,  16  m  at  Y  =  40  and  30  m,  18  m  at  Y  =  20  and  10 
m,  and  20  m  at  the  outlet  (i.e.,  Y  =  0  m).  The  width  changes  linearly  between  any  two  consecutive  locations 
mentioned  above.  The  system  is  initially  dry.  A  variable  rainfall  is  applied  to  the  system  during  a  two-hour 
simulation,  which  is  5xl0  7  m/s  during  the  first  twenty  minutes,  lxl0'6  m/s  between  20  and  40  minutes,  2x1  O'6 
m/s  between  40  and  60  minutes,  no  rainfall  between  60  and  80  minutes,  4x10  m/s  between  80  and  100 
minutes,  and  5x1 0‘7  m/s  for  the  last  twenty  minutes  of  the  simulation.  A  constant  water  depth  of  0  m  is  set 
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at  the  ridge  top  of  the  system  during  the  simulation.  A  water  depth-dependent  flux  boundary  condition  is 
employed  on  the  interface  between  2-D  overland  and  1-D  river/stream  to  determine  the  injection  of  water 
from  overland  to  river/stream.  Impermeable  boundary  condition  is  employed  for  the  overland  boundary  at 
Y  =  0  m  (X  =  -400  to  -10  m  and  X  =  10  to  400  m).  The  upstream  end  of  the  river/stream  is  treated  as  a 
junction,  where  water  budget  is  used  to  determine  the  water  depth  there.  A  water  depth-dependent  flow  rate 
boundary  condition  is  used  to  compute  the  water  going  out  from  the  river/stream  downstream  boundary, 
which  is  also  the  only  outlet  of  the  system.  The  time  step  size  for  2-D  overland  flow  computation  is  20 
seconds  and  it  is  2  seconds  for  calculating  1-D  river/stream  flow  (i.e.,  1  2-D  time  step  =  10  1-D  time  steps). 

Figures  4.39  and  4.40  plot  water  depth  and  velocity,  respectively,  at  various  times  for  1-D 
river/stream  along  the  river  downstream  (i.e.,  from  Y=1000  m  to  Y=0.0  m).  Figure  4.41  depicts  the  contour 
of  water  depth  at  various  times  for  2-D  overland.  From  Figure  4.39,  we  can  easily  observe  the  back  water 
effect  due  to  the  depth-dependent  flow  rate  at  the  outlet  of  1-D  river/stream.  Also,  we  see  that  the  junction 
(at  X  =  0  m  in  Figures  3.39  and  3.40)  collects  water  from  the  converging  overland  flow  and  has  the  largest 
water  depth  in  the  river/stream.  This  seems  contradictory  to  our  intuition.  However,  such  a  result  is  the 
consequence  of  the  widening  of  river  width  from  upstream  to  downstream  and  a  relatively  flat  river  bottom. 
Figure  4.41  illustrates  how  water  depth  changes  with  rainfall  rates  in  the  overland  domain.  We  can  also 
observe  the  back  water  effect  due  to  the  depth-dependent  normal  flux  given  on  the  river/stream-  and  junction- 
related  downstream  boundary  (i.e.,  the  1-D/2-D  interface  boundary). 


4,8.  Example  of  1-D/2-D  flow  and  transport 

This  example  considers  both  flow  and  transport  in  1-D  river/stream  and  2-D  overland.  The 
topography  and  grids  are  shown  in  Figure  4.42  where  flow  is  driven  into  the  river/stream  from  the  overland 
simply  due  to  gravity.  The  slope  of  river  bottom  elevation  is  0.01.  The  river/stream  has  a  uniform  width 
of  10  m.  The  system  is  initially  dry.  A  variable  rainfall  is  applied  to  the  system  during  a  two-hour 
simulation,  which  is  10'5  m/s  during  the  first  twenty  minutes,  2xl0'5  m/s  between  20  and  40  minutes,  10'5  m/s 
between  40  and  60  minutes,  2xl0'5  m/s  between  60  and  80  minutes,  10'5  m/s  between  80  and  100  minutes, 
and  no  rainfall  for  the  last  twenty  minutes  of  the  simulation.  A  constant  water  depth  of  1CT4  m  is  set  at  the 
ridge  top  of  the  system  during  the  simulation.  A  water  depth-dependent  flux  boundary  condition  is  employed 
on  the  interface  between  2-D  overland  and  1  -D  river/ stream  to  determine  the  inj  ection  of  water  from  overland 
to  river/stream.  Impermeable  boundary  condition  is  employed  for  the  overland  boundary  at  Y  =  0  m  and  Y 
=  900  m  (X  =  200  to  595  m  and  X  =  605  to  1000  m).  Water  depth  is  maintained  at  10'3  m  at  the  upstream 
end  of  the  river/stream.  A  water  depth-dependent  flow  rate  boundary  condition  is  used  to  compute  the  water 
going  out  from  the  river/stream  downstream  boundary.  Manning’ s  roughness  is  0.01  for  overland  and  0.03 
for  river/stream.  The  time  step  size  for  2-D  overland  flow  computation  is  10  seconds  and  it  is  2  seconds  for 
calculating  1-D  river/stream  flow. 

As  for  the  transport  simulation,  six  dissolved  chemicals  and  two  reactions  are  taken  into  account. 
Among  the  six  chemicals,  five  of  them  are  involved  in  the  two  reactions  as  described  in  the  following  and 
the  other  one  is  non-reactive. 


Cl 

IS  1 

10  1 
+ 

kf 

=  0.01, 

kb 

=  0.005 

(4.17) 

cl 

+  C3  *  C5 

kf 

=  0.01, 

kb 

=  0.005 

(4.18) 

The  dissolved  chemical  C5  is  radioactive  and  the  decay  constant  is  10^  1/s.  Cl  ,  C2  ,  C3  , 
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and  C6  exist  in  rainfall  with  a  constant  concentration  of  1  g/m3.  In  2-D  overland  transport,  variable 
boundary  conditions  are  applied  on  both  the  upstream  boundary  (i.e.,  ridge  top),  where  the  concentration  is 
1  g/m3  for  Cl  C2  ,  C3  ,  and  C6  ,  and  is  0  g/m3  for  the  other  two  chemicals  if  the  flow  is  directed 
into  the  domain  of  interest.  For  the  overland-river  interface,  we  also  apply  variable  boundary  conditions  by 
using  the  respective  concentrations  in  the  channel  as  the  incoming  concentrations  when  the  flow  is  directed 
from  river/stream  to  overland  on  the  interface  boundary .  As  for  1  -D  river/ stream  transport,  the  same  variable 
boundary  condition  as  is  employed  for  the  overland  ridge  top  is  applied  to  both  the  upstream  and  the 
downstream  boundary  nodes  (i.e.,  located  at  (600  m,  900  m)  and  (600  m,  0  m),  respectively). 

Figure  4.43  plots  water  depth  at  various  times  for  1-D  river/stream  along  the  river  downstream. 
Figure  4.44  plots  water  depth  at  various  times  for  2-D  overland.  Figures  4.45  through  4.50  depict  the 
concentration  of  the  first  through  the  sixth  dissolved  chemicals,  respectively,  at  various  times  for  1-D 
transport.  Figures  4.51  through  4.56  show  the  concentration  of  the  first  through  the  sixth  dissolved 
chemicals,  respectively,  at  various  times  for  2-D  overland. 

Both  Figures  4.43  and  4.44  indicate  that  steady  state  have  been  reached  by  the  end  of  each  constant 
rainfall  period  of  time  (each  rainfall  period  lasts  for  twenty  minutes).  For  both  1-D  and  2-D  flows,  the  back 
water  effect  is  obvious.  The  reason  has  been  given  in  the  previous  example.  Figures  4.50  and  4.56  show  the 
uniformly  distributed  concentration  of  the  nonreactive  dissolved  chemical  in  1-D  and  2-D,  respectively.  This 
numerical  result  help  to  verify  our  model  when  1-D  flow,  2-D  flow,  1-D  transport,  and  2-D  transport  are  all 
taken  into  account. 

Since  the  second  and  the  third  dissolved  chemicals  are  involved  in  identical  aqueous  complexation 
reactions,  they  should  have  the  same  concentration  distribution,  so  should  their  respective  product  chemicals 
(i.e.,  the  fourth  and  the  fifth  chemicals,  respectively).  However,  the  radioactive  nature  of  the  fifth  chemical 
makes  the  difference  between  them  as  well  as  the  difference  between  their  respect  product  chemicals.  On 
the  other  hand,  the  decay  is  so  slow  so  that  the  difference  mentioned  above  is  almost  invisible  (compare 
Figures  4.46  with  4.47,  Figures  4.48  with  4.49,  Figures  4.52  with  4.53,  and  Figures  4.54  with  4.55). 


4.9.  Example  of  3-D  subsurface  flow 


This  example  was  designed  to  demonstrate  a  3-D  flow  simulation  with  the  3DFEMWATER  model 
[Yeh  and  Cheng,  1993].  Since  the  computational  results  from  our  watershed  model  matches  that  from 
3DFEMWATER  perfectly,  we  have  verified  the  3-D  subsurface  flow  module  with  this  example.  The 
description  of  the  example  is  as  follows.  The  example  involves  the  steady  flow  to  a  pumping  well  where  the 
total  head  is  maintained  at  30  m  during  pumping.  The  region  of  interest  is  bounded  on  the  left  (x  =  0  m)  and 
right  (x  =  1000  m)  by  hydraulically  connected  rivers;  on  the  front  (y  =  -400  m),  back  (y  =  400  m),  and  bottom 
(z  =  0  m)  by  impervious  aquifuges;  and  on  the  top  (z  =  72  m)  by  an  air-soil  interface.  The  pumping  well  is 
located  at  (540,0).  The  water  table  is  assumed  to  be  horizontal  and  is  60  m  above  the  bottom  of  the  aquifer 
before  pumping.  The  saturated  hydraulic  conductivity  has  components  Kxx  =  5  m/d,  Kyy  =  0.5  m/d,  and  kzz 
=  2  m/d.  The  porosity  of  the  medium  is  0.25  and  the  field  capacity  is  0.0125.  The  following  two  equations 
are  taken  to  describe  the  unsaturated  hydraulic  properties. 


0 


er+(es-er) 


1  +(a|ha_hl)13 


(4.19) 
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(4.20) 


where  0S  is  porosity;  0r  is  the  minimum  moisture  content  that  is  associated  with  the  minimum  pressure  head 
ha;  a  and  P  are  parameters  used  to  compute  the  moisture  content  and  relative  hydraulic  conductivity. 
Because  of  the  symmetry,  the  region  for  numerical  simulation  is  taken  as  x  6  [0  m,  1000  m],  y  G  [0  m,  400 
m],  z  e  [0  m,  72  m],  the  boundary  condition  are  given  as:  pressure  head  is  assumed  hydrostatic  on  two 
vertical  planes  at  (1)  x  =  0  m  and  z  6  [0  m,  60  m]  and  (2)  x  =  1000  m  and  z  G  [0  m,  60  m] ;  no  flux  in  imposed 
on  all  other  boundaries  of  the  flow  regime.  The  steady-state  solution  corresponding  to  the  above  boundary 
conditions  is  sought  with  the  pressure  head  error  tolerances  of  0.01  m  and  0.005  m  as  the  criteria  to 
determine  convergence  for  nonlinear  iterations  and  linear  matrix  solvers,  respectively.  The  steady-state 
solution  is  plotted  in  Figure  4.57. 


4.10.  Example  of  3-D  subsurface  transport 

This  example  is  to  demonstrate  the  capability  of  the  model  in  simulating  kinetics  chemical  transport 
in  a  3-D  domain.  A  1000  cm  long,  100  cm  wide,  and  40  cm  deep  region  is  considered.  It  is  discretized  with 
nonuniform  hexahedral  elements  (Figure  4.58).  To  focus  on  transport,  we  assume  a  constant  effective 
porosity  of  0.3  throughout  the  entire  domain  that  is  saturated.  The  Darcy  velocity  (specific  discharge)  is  0.3 
cm/minute.  Three  dissolved  chemicals  are  considered  to  undergo  the  following  reaction. 


Cl  +  2C2  *  C4 

O 

O 

II 

kb  =  0.005 

(4.21) 

Cl  +  C3  *  C5 

*-n 

II 

o 

b 

kb  =  0.0025 

(4.22) 

where  Cl  ,  C2  ,  C3  ,  C4  ,  and  C5  represent  dissolved  chemicals. 

The  following  adsorption  reactions,  with  two  adsorbing  sites  and  two  adsorbed  chemicals  involved, 
are  also  considered. 


Cl 

+  SITE1  **  SORB1 

*- 

►*> 

II 

O 

kb 

=  0.0005 

(4.23) 

C2 

+  SITE2  **  SORB  2 

kf  =  0.002, 

kb 

=  0.0005 

(4.24) 

where  SITE1  and  SITE2  are  adsorbing  sites;  SORB1  and  SORB2  are  adsorbed  chemicals. 

Initially,  there  contain  no  dissolved  chemicals,  nor  adsorbed  chemicals.  Only  are  adsorbing  sites  in 
the  domain  of  interest.  The  initial  concentration  is  0.1  g/cm3  for  both  adsorbing  sties.  The  boundary 
conditions  for  the  transient  simulation  are:  no  flux  for  the  top  (z  =  40  cm),  the  bottom  (z  =  0  cm),  the  front 
(y  =  0  cm)  and  the  back  (y  =  100  cm)  boundaries;  flow-out  variable  boundary  condition  (or  zero  Neumann 
flux)  for  the  downstream  boundary  (x  =  1000  cm);  Dirichlet  boundary  conditions  applied  to  the  boundary 
nodes  included  in  the  patch  area  of  y  G  [30  cm,  70  cm]  and  z  e  [16  cm,  24  m]  on  the  upstream  boundary  (x 
=  0  cm)  where  a  constant  concentration  of  1  g/cm3  are  maintained  for  the  first  three  dissolved  chemicals  and 
zero  concentration  is  set  for  the  other  two  dissolved  chemicals ;  flow-in  variable  boundary  condition  with  zero 
concentration  for  the  upstream  boundary  area  that  is  not  included  in  the  aforementioned  patch.  The 
longitudinal  dispersivity  is  0.01  cm,  the  transverse  dispersivity  is  0.001  cm,  and  the  molecular  diffusion 
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coefficient  is  10'5  cm2/minute.  A  60  hour  simulation  is  performed  with  a  fixed  time  step  size  of  10  minutes. 
A  relative  error  of  1 0"*  is  used  to  determine  convergence  for  both  linear  and  nonlinear  iterations  involved 
in  the  computation. 

Figures  4.59  through  4.62  depict  the  numerical  results  at  the  end  of  simulation  for  Cl  ,  C4  , 

SITE1  ,  and  SORB1  .respectively.  In  each  figure,  we  plot  the  concentration  contours  on  the  planes  of 

y  =  50  cm  and  z  =  20  cm  for  clear  views  for  readers  to  visualize.  The  results  shown  on  these  figures  provide 
not  only  the  qualitative  description  of  what  is  happening  in  the  system,  which  we  can  expect  from  the 
chemical  reactions  taken  into  account  and  from  the  boundary  conditions  set  for  the  simulation,  but  a 
quantitative  analysis  on  the  concentration  distribution  at  time  =  60  hours.  The  highest  concentration  of 
CT  is  1.0  g/cm3  which  is  the  given  Dirichlet  boundary  condition  at  nodes  in  the  patch  area  on  the 
upstream  boundary  because  the  reactions  involving  Cl  (i.e.,  Eqs.  (4.21)  through  (4.23))  cause  the 
consumption  of  Cl  whenjt  enters  the  domain  along  with  the  flow.  The  highest  concentration  is  0.21 153 
g/cm3  at  (2 1 0, 50, 20)  for  C4_ ,  whichresults  from  its  production  through  aqueous  complexation  (Eq.  (4.2 1 )) 
and  the  decreasing  of  both  Cl  and  C2  along  the  x-direction.  On  the  upstream  boundary  patch,  the  highest 
concentration  of  SORB1  (0.0663652  g/cm3)  and  the  lowest  concentration  of  SITE1  (0.033634  g/cm3)  are 
found  due  to  the  adsorption  (Eq.  (4.23)). 


4.11.  Example  of  3-D  subsurface  flow  and  transport 

This  example  is  to  demonstrate  the  capability  the  model  has  to  handle  both  3-D  subsurface  flow  and 
transport.  In  this  example,  the  initial  flow  condition  is  computed  by  solving  the  steady-state  flow  governing 
equation  based  on  the  given  boundary  conditions,  where  an  impermeable  boundary  condition  is  applied  to 
the  front  (y  =  0  m),  back  (y  =  100  m),  and  bottom  (z  =  0  m)  boundaries;  a  total  head  of  26  m  is  specified  on 
the  lower  part  of  the  left  boundary  (x  =  0  m  and  z  <  26  m);  a  total  head  of  13  m  is  specified  on  the  lower  part 
of  the  right  boundary  (x  =  1000  m  and  z  <  13  m);  a  variable  boundary  condition  of  zero  ponding  depth  and 
zero  rainfall  flux  is  applied  to  the  upper  part  of  right  and  left  boundaries;  a  variable  boundary  condition  of 
zero  ponding  depth  and  a  rainfall  rate  of  10’5  m/sec  is  used  for  the  top  boundary  (i.e.,  the  ground  surface 
boundary)  in  the  6  hour  transient  simulation.  In  determining  the  initial  steady-state  flow  condition,  zero 
rainfall  rater  is  employed  for  the  top  boundary.  Figure  4.63  shows  the  domain  and  discretization  for  the 
simulation  here.  The  saturated  hydraulic  conductivity  has  components  =  2x10"*  m/s,  Kyy  =  10  5  m/s,  and 
k22  =  10‘5  m/s.  The  following  soil  characteristic  equations  are  used  to  describe  the  hydraulic  properties  in 
unsaturated  zones. 

0  =  0.3  if  0<h 

6  =  0.15 +0.0015  (h  + 100)  if  -100<h<0  (4.25) 

0  =  0.15  if  h<  -100 

Kr  =  1  if  0<h 

K  =  h  +  1Q°  if  -100<h<0  (4.26) 

r  100 

Kr  =  0  if  h<  -100 

In  the  transport  simulation  the  following  reaction,  with  three  dissolved  chemicals  involved,  is 
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considered. 


Cl  +  C2  *  2C3  kf  =  0.01,  kb  =  0.001  (4.27) 

Initially,  no  chemicals  exist  in  the  domain.  As  the  transient  simulation  starts.  Cl  and  C2  of  1 
g/m3  are  brought  into  the  subsurface  domain  through  rainfall  on  a  part  of  the  top  boundary  (x  £  [60  m,  500 
m] )  and  this  is  the  only  source  that  chemicals  would  enter  the  domain.  To  achieve  the  transient  simulation 
associated  with  such  a  condition,  we  employ  variable  boundary  conditions  for  the  top,  the  right,  and  the  left 
boundaries,  with  a  concentration  of  1  g/m3  associated  with  the  incoming  flow  for  the  1st  and  2nd  dissolved 
chemicals  on  the  restricted  top  boundary  and  a  zero  incoming  concentration  for  the  rest  of  the  variable 
boundary  and  for  the  3rd  dissolved  chemical.  We  also  apply  the  no-flux  condition  for  the  front,  the  back,  and 
the  bottom  boundaries.  The  time  step  size  is  100  seconds  for  computing  flow  and  is  5  seconds  for  computing 
chemical  transport.  In  other  words,  one  flow  time  step  contains  20  transport  time  steps.  An  absolute  error 
of  0.001  m  is  used  to  determine  convergent  flow  solutions,  while  a  relative  error  of  0.0001  is  take  as  the 
stopping  criterion  for  solving  both  linear  and  nonlinear  equations  in  the  transport  simulation. 

Figures  4.64  through  4.66  plot  the  numerical  results  of  pressure  head,  the  concentration  of  the  Is1  (or 
the  2nd)  dissolved  chemical,  and  the  concentration  of  the  3rd  dissolve  chemical,  respectively,  on  the  plane  of 
y  =  50  m  at  various  times.  At  the  end  of  simulation  (time  =  6  hours,  Figure  4.64),  we  can  observe  unsaturated 
zones  close  to  the  upper  part  of  the  right  and  the  left  boundaries  because  infiltration,  contributed  only  by 
rainfall,  does  not  provide  enough  water  to  make  saturation  for  the  two  parts.  Since  the  part  on  the  right  has 
a  low  elevation,  it  should  allow  water  to  accumulate  on  ground  surface  through  surface  runoff  after  the 
subsurface  cannot  absorb  rainfall  completely  at  higher  elevation.  This  missing  of  accounting  for  surface 
runoff  can  lead  to  errant  simulation  results  in  many  cases.  That  is  to  say,  the  coupling  of  surface  and 
subsurface  systems  is  needed  when  surface  runoff  is  not  negligible.  Without  surface  runoff  taken  into 
account,  the  migration  of  chemicals  to  the  right  boundary  is  slow  (Figures  4.65  and  4.66).  This  also  indicates 
a  possibility  of  incorrect  estimate  on  chemical  distribution  when  only  is  the  subsurface  system  considered. 
We  will  demonstrate  different  simulation  results  on  both  flow  and  chemical  transport  in  Section  4. 13,  where 
the  coupling  of  surface  and  subsurface  systems  is  considered. 


4.12.  Example  of  2-D/3-D  flow 

The  domain  of  interest  for  this  example  is  identical  to  that  for  the  3-D  flow  and  transport  example 
(Figure  4.63  in  Section  4.1 1).  The  initial  condition  is  also  computed  according  to  the  boundary  conditions 
the  same  as  those  in  Section  4.1 1.  The  rainfall  is  2xl0'5  m/s  during  the  1st  twenty  minutes.  Then  rain  stops 
for  1  hour,  followed  by  a  rainfall  of  10'5  m/s  for  1  hour  and  1 .5xl0‘5  m/s  afterwards  till  the  end  of  simulation 
(time  =  6  hours).  The  water  depth  is  set  to  zero  for  the  highest  location  of  the  2-D  overland  domain  (i.e.,  at 
x  =  0  m),  while  a  depth-dependent  flux  is  given  for  the  boundary  condition  at  the  lowest  location  (i.e.,  at  x 
=  1000  m).  The  rest  of  the  overland  boundary  is  assumed  no-flux  (i.e.,  at  y  =  0  m  and  y  =  100  m).  The  water 
depth  computed  from  2-D  overland  flow  is  used  as  the  ponding  depth  for  implementing  the  variable  boundary 
condition  on  the  top  boundary  of  3-D  subsurface  flow.  The  remaining  boundary  conditions  for  computed 
3-D  subsurface  flow  are  set  identical  to  those  in  Section  4.1 1.  A  relative  error  of  10-4  is  used  to  determine 
convergence  for  2-D  overland  flow,  and  an  absolute  error  of  10'3  m  is  employed  to  identify  a  convergent 
solution  of  3-D  subsurface  flow.  The  time  step  sizes  for  3-D  and  2-D  computation  are  100  seconds  and  2 
seconds,  respectively. 

Figure  4.67  plots  the  depth  of  2-D  overland  flow  at  various  times  and  Figure  4.68  shows  the  pressure 
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head  distribution  on  the  y  =  50  m  plane  at  various  times.  From  the  top  two  graphs  of  Figure  4.67,  it  is 
obvious  that  the  rainfall  in  the  first  twenty  minutes  is  absolutely  absorbed  into  3-D  subsurface.  In  the 
meantime,  moisture  content  in  the  unsaturated  zone  (the  blue  band  in  Figure  4.68)  increases  with  time  due 
to  this  infiltration  contribution.  When  rain  stops,  water  drainage  caused  by  gravity  decreases  moisture 
content  in  the  unsaturated  zone.  As  soon  as  rain  is  resumed,  moisture  content  increases  again,  and  saturated 
area  expends  in  the  uphill  direction.  Also,  we  can  observe  the  accumulation  of  water  on  ground  surface  after 
the  soil  cannot  accept  all  rainfall  water  (Figures  4.67  and  4.68).  At  the  end  of  simulation  (time  =  6  hours), 
there  is  only  a  small  unsaturated  zone  next  to  the  highest  location  of  the  system. 


4.13.  Example  of  2-D/3-D  flow  and  transport 

The  flow  conditions  for  this  example  is  the  same  as  those  for  the  2-D/3-D  flow  example  in  Section 
4.12,  except  the  rainfall  is  constant  at  10'5  m/s  during  the  6  hour  simulation  period.  There  is  one  aqueous 
complexation  reaction  considered  as  follows. 

Cl  +  2C2  **  C3  kf  =  0.001,  kb  =  0.0001  (4.28) 

Initially,  no  chemicals  exist  in  the  domain.  As  the  transient  simulation  starts.  Cl  and  C2  of  1 
g/m3  exist  in  the  rainfall  that  falls  on  a  part  of  the  overland  surface  (x  e  [60  m,  500  m] ),  but  do  not  appear 
in  the  precipitation  falling  onto  the  rest  of  overland  surface.  To  achieve  the  transient  simulation  associated 
with  such  a  condition,  we  employ  surface/subsurface  variable  boundary  conditions  for  the  top  boundary  and 
a  variable  boundary  condition  with  a  zero  incoming  concentration  for  the  right  and  left  subsurface 
boundaries.  We  also  apply  the  no-flux  condition  for  the  front,  the  back,  and  the  bottom  boundaries. 

Variable  time  step  sizes,  10  seconds  from  0  to  40  seconds,  40  seconds  from  40  to  200  seconds,  100 
seconds  from  200  seconds  to  20  minutes,  and  150  seconds  fro  the  rest  of  the  simulation,  are  used  for 
computing  3-D  subsurface  flow  and  is  5  seconds  for  computing  3-D  subsurface  transport,  2-D  overland  flow, 
and  2-D  overland  transport.  An  absolute  error  of  0.001  m  is  used  to  determine  convergence  for  3-D  flow, 
while  a  relative  error  of  0.0001  is  take  as  the  stopping  criterion  for  obtaining  convergent  solutions  in  3-D 
transport,  2-D  flow,  and  2-D  transport. 

Figures  4.69  and  4.70  depict  2-D  overland  water  depth  and  3-D  subsurface  pressure  head  at  various 
times.  Figures  4.7 1  and  4.72  show  the  concentration  distributions  at  time  =  6  hours.  By  taking  surface  runoff 
into  account  (Figure  4.69),  we  do  not  observe  unsaturated  zone  near  the  upper  right  comer  (Figure  4.70), 
which  is  different  from  what  we  have  obtained  in  Section  4.11  (Figure  4.64).  Surface  runoff  also  takes 
chemicals  down  to  the  right  part  of  the  system  (Figure  4.71),  and  chemicals  enter  the  subsurface  through 
infiltration  not  only  in  x  e  [60  m,  500  m]  but  in  x  e  [500  m,  1000  m]  (Figure  4.72). 


4.14.  Example  of  1-D/2-D/3-D  flow 

In  this  example,  we  consider  a  coupled  1-D/2-D/3-D  flow  system  that  is  discretized  as  shown  in 
Figure  4.73.  Initially,  ground  surface  is  dry  and  the  subsurface  is  assumed  at  a  steady  state  that  is  determined 
by  the  following  boundary  conditions:  no  flux  on  the  left  (x  =  100  m),  the  right  (x  =  900  m),  and  the  bottom 
(z  =  0  m)  boundaries,  a  constant  total  head  of  10  m  for  the  lower  part  (z  <;  10  m)  of  both  the  front  (y  —  0  m) 
and  the  back  (y  =  900  m)  boundaries;  variable  boundary  condition  of  zero  depth  and  zero  rainfall  for  the 
surface  on  the  top  and  for  the  rest  of  the  front  and  the  back  boundary  surfaces.  The  unsaturated  soil 
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characteristics  are  described  by  Eqs.  (4.25)  and  (4.26).  The  saturated  conductivities  are  K*x  —  10"4  m/s,  Kyy 
=  10“5  m/s,  and  =  SxlO-6  m/s.  The  geometry  and  discretization  of  the  1-D/2-D  surface  system  here  is 
identical  to  that  given  in  Section  4.8  and  is  not  described  again.  The  boundary  conditions  used  for  computing 
surface  flow  are  the  same  as  those  employed  in  Section  4.8,  except  the  water  depth  is  forced  to  be  zero  at  the 
upstream  river/stream  end  (i.e.,  x  =  500  m  and  y  =  900  m)  and  on  the  top  ridge  of  the  overland  domain  (i.e., 
x  =  100  m  and  x  =  900  m).  As  the  transient  simulation  begins,  a  rainfall  of  10‘5  m/s  during  the  1st  hour  and 
1 .5xl0'5  m/s  for  the  next  1 1  hours  is  applied  to  the  system.  An  absolute  error  of  0.01  m  is  taken  to  determine 
3-D  flow  convergence,  and  a  relative  error  of  0.0001  is  used  to  determine  convergent  solutions  for  both  1-D 
and  2-D  flow.  Variable  time  step  sizes  of  10  seconds  from  the  beginning  to  40  seconds,  40  seconds  from  40 
to  200  seconds,  100  seconds.from  200  to  600  seconds,  150  seconds  from  600  to  1200  seconds,  200  seconds 
from  1200  seconds  to  1  hour,  and  250  seconds  from  1  hours  to  12  hours  are  used  for  3-D  flow  computation. 
A  constant  time  step  size  of  2  seconds  is  used  in  calculating  both  1-D  and  2-D  flow. 

Figures  4.74  and  4.75  plot  the  water  depth  on  1-D  and  2-D  domains,  respectively,  at  various  times. 
Figures  4.76  and  4.77  depict  the  pressure  head  distribution  and  the  Darcy  velocity  (specific  discharge), 
respectively,  on  four  vertical  planes  (y  =  100  m,  y  =  800  m,  x  =  500  m,  and  x  =  800  m)  at  various  times.  By 
matching  Figures  4.74  through  4.76,  we  observe  that  the  rainfall  during  the  1st  hour  is  completely  absorbed 
by  ground  soil,  some  water  accumulates  on  ground  surface  and  surface  water  flow  exists  at  Time  =  4  hours, 
and  the  entire  surface  domain,  except  for  those  boundary  nodes  at  high  locations  (specified  with  zero  depth 
boundary  condition),  is  covered  with  water  at  the  end  of  simulation  (Time  =12  hours).  Figure  4.77  gives 
us  the  idea  how  the  Darcy  velocity  varies  with  time  in  this  example.  Basically,  water  movement  is  observed 
in  the  unsaturated  zone  (or  the  upper  part)  of  the  subsurface  domain.  It  starts  from  surf  ace/ subsurf  ace 
boundary  due  to  infiltration.  Its  downward  velocity  increases  with  time  first  because  the  input  of  water  from 
the  top  builds  up  head  gradient  in  the  unsaturated  zone  (from  Time  =  20  minutes  to  4  hours),  but  decreases 
when  the  saturated  zone  expends  and  reduces  head  gradient  subsequently  (from  Time  =  4  hours  to  12  hours). 


4.15.  Example  of  1-D/2-D/3-D  flow  and  transport 

This  example  considers  the  most  complicated  situation  that  the  model  can  handle:  a  coupled  system 
of  1-D/2-D/3-D  flow  and  transport.  The  domain  geometry  and  flow  condition  here  is  identical  to  that  in  the 
previous  section,  except  the  saturated  conductivity  in  the  z-direction  for  3-D  subsurface  flow  is  =  2x10 6 
m/s.  In  chemical/sediment  transport  there  are  three  dissolved  chemicals  (  Cl  ,  C2  ,  and  C3  ),  one 
suspended  and  one  bed  sediments  (  SSI  and  BS1  ),  three  particulate  chemicals  each  on  the  suspended 
and  the  bed  sediments  (  PS  1  ,  PS2  ,  PS3  ,  and  PB 1  ,  PB2  ,  PB3  ),  one  adsorbing  site  (  SITE  1  ), 
and  three  adsorbed  chemicals  (  SORB1  ,  SORB2  ,  and  SORB3  ).  The  sediment  size  is  of  cohesive 
type.  The  settling  speed  is  4.5xl04  m/s.  The  critical  shear  stresses  for  deposition  and  erosion  are  4.75  g/m/s2 
and  4.68  g/m/s2,  respectively.  The  following  reactions  are  taken  into  account. 


cl  +  C2  **  C3  kf 

II 

o 

© 

5*T 

cr 

11 

0.005 

(4.29) 

Cl 

+  ssT  *  psI  +  ssT 

kf  =  0.0001, 

FT 

o* 

II 

o 

o 

(4.30) 

C2 

+  SSI  **  PS2  +  ssl 

kf  =  0.0001, 

a* 

II 

O 

© 

(4.31) 
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C3  +  SSl  *•  PS3  +  ssT 

kf  =  0.0001,  kb  =  0.0 

(4.32) 

cT  +  bsI  **  pbT  +  bsT 

kf  =  0.00001,  kb  =  0.0 

(4.33) 

C2  +  BSl  *  PB2  +  BSl 

kf  =  0.00001,  kb  =  0.0 

(4.34) 

C3  +  BSl  *  PB3  +  BSl 

kf  =  0.00001,  kb  =  0.0 

(4.35) 

Cl  +  SITE1  **  SORB1 

kf  =  0.001,  kb  =  0.0002 

(4.36) 

C2  +  SITE1  **  SORB2 

kf  =  0.001,  kb  =  0.0001 

(4.37) 

C3  +  SITE1  -  SORB3 

n 

o 

8 

^7* 

CT 

II 

o 

o 

(4.38) 

Initially,  only  do  bed  sediments  and  adsorbing  sites  exist  in  the  system.  The  initial  concentrations 
are  10  g/m3  for  the  bed  sediment  on  overland,  100  g/m3  for  the  bed  sediment  in  river/stream,  and  2  g/m3  for 
the  adsorbing  site.  As  the  transient  simulation  starts,  Cl  ,  C2  ,and  C3  of  1  g/m3  come  into  the  system 
through  rainfall  and  this  is  the  only  source  that  chemicals  would  enter  the  system.  To  achieve  the  transient 
simulation  associated  with  such  a  condition,  we  employ  surface/subsurface  variable  boundary  conditions  for 
the  top  boundary  and  a  variable  boundary  condition  with  a  zero  incoming  concentration  for  the  front  (y  =  0 
m)  and  back  (y  =  900  m)  subsurface  boundaries.  In  addition,  we  apply  the  no-flux  condition  for  the  right  (x 
=  900  m),  the  left  (x  =  100  m),  and  the  bottom  (z  =  0  m)  boundaries  (Figure  4.73).  A  relative  error  of  lO'4 
is  used  to  determine  convergence  in  transport  computations.  The  longitudinal  dispersivity  is  0. 1  m,  the 
transverse  dispersivity  is  0.01  m,  and  the  diffusion  coefficient  is  10  5  m2/s.  Time  step  sizes  for  3-D  flow  is 
the  same  as  those  in  the  previous  section,  but  10  seconds  and  2.5  seconds  are  used  for  2-D  and  1-D 
simulations,  respectively. 

Figures  4.78  through  4.80  show  the  numerical  results  of  river/stream  water  depth,  overland  water 
depth,  and  subsurface  pressure  head  at  various  times  of  the  12  hour  simulation.  Figures  4.8 1  through  4.83 
plot  the  concentration  distribution  of  dissolved  chemicals  in  1-D,  2-D,  and  3-D  domains,  respectively,  at  the 
end  of  simulation.  Figures  4.84  and  4.85  plot  the  sediment  concentrations  in  1-D  and  2-D  systems, 
respectively.  Figures  4.86  and  4.87  depict  the  first  particulate  chemicals  on  sediments  in  1-D  and  2-D 
systems,  respectively.  Figures  4.88  shows  the  concentration  of  the  adsorbing  site  and  adsorbed  chemicals 
in  the  3-D  subsurface  domain. 

With  a  smaller  in  the  subsurface,  we  observe  more  water  on  surface  in  this  example  than  that  in 
the  previous  one  (i.e.,  in  Section  4.14).  Because  the  water  depth  is  set  to  be  zero  on  the  upstream  boundary 
of  both  overland  and  river/stream  systems,  we  always  define  zero  concentration  associated  with  those 
boundary  nodes  (Figures  4.8 1 , 4.82, 4.86,  and  4.87).  We  observe  the  removal  of  bed  sediment  in  river/stream 
(Figure  4.84)  but  do  not  have  change  of  sediment  distribution  on  overland  (Figure  4.85).  This  can  also  be 
verified  by  matching  Figure  4.84  with  Figure  4.86  and  Figure  4.85  with  Figure  4.87.  In  this  example, 
infiltration  exists  on  the  surface/subsurface  interface  through  the  entire  simulation.  Therefore,  the  incoming 
variable  boundary  condition  is  used  to  account  for  the  top  boundary  in  dealing  with3-D  subsurface  transport. 

Because  of  this  and  because  the  chemistry  in  the  surface  system  is  the  same  for  Cl  and  C2  (Eqs.  (4.29), 

(4.30),  (4.31),  (4.33),  and  (4.34)),  we  obtain  identical  concentration  distribution  for  these  two  dissolved 
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chemicals  (Figures  4.81  and  4.82).  However,  their  concentration  distributions  are  not  same  in  the  subsurface 
(Figure  4.83)  because  they  are  involved  in  adsorption  reactions  with  different  backward  rate  constants  (Eqs. 
(4.36)  and  (4.37)).  Among  the  adsorbed  chemicals,  SORB 3  has  the  highest  maximum  concentration 
while  SORB1  has  the  lowest  maximum  concentration  (Figure  4.88).  This  is  mainly  because  the  backward 
reaction  rate  constant  associated  with  SORB3  is  the  smallest  (kb  =  0)  and  that  associated  with  SORB  1 
is  the  largest  (K*  =  0.0002)  among  the  three  adsorption  reactions. 
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Section  5.  SUMMARY  AND  CONTINUING  WORK 


A  numerical  model  has  been  developed  to  simulate  water  flow  and  sediment  and  reactive  chemical 
transport  in  watershed  systems.  The  mathematical  basis  and  numerical  approaches  of  the  model  was  given 
in  Sections  2  and  3.  Section  4  has  demonstrated  that  the  model  was  able  to  deal  with  various  configurations 
of  problems  involving  flow  and  sediment  and  chemical  transport  over  watersheds  with  a  wide  range  of 
ground  surface  slopes.  Fifteen  example  problems  were  presented  to  illustrate  the  basic  capability  of  the 
model. 


Much  experience  has  been  gained  throughout  the  research  of  this  project.  It  was  demonstrated  that 
the  method  of  characteristics  can  provide  accurate  numerical  simulations  in  solving  the  dynamic  wave  model 
when  slopes  of  the  ground  surface  are  small.  However,  its  application  to  solving  problems  with  steep  slopes 
has  proved  elusive.  On  the  other  hand,  the  Lagrangian  approach  was  illustrated  to  be  robust  in  solving 
diffusion  and  kinematic  wave  models.  However,  kinematic  and  diffusion  wave  models  can  yield  accurate 
solutions  only  for  cases  of  mild  to  steep  slope  problems.  For  cases  of  problems  involving  small  slopes,  the 
kinematic/diffusion  wave  models  could  not  generate  accurate  results,  even  through  the  models  can  be  solved 
easily.  The  kinematic  wave  model  cannot  address  the  effects  of  backwater  on  flow  dynamics  over 
watersheds.  In  consideration  of  robustness  (i.e.,  easy  to  solve  with  numerical  methods)  and  accuracies,  a 
hybrid  model  of  adaptively  choosing  appropriate  models  (kinematic,  diffusion,  or  dynamic  wave  models) 
for  different  regions  of  a  watershed  is  desirable. 

Using  the  predictor-corrector  approach  to  solving  the  transport  equations,  we  have  made  the 
computation  effective  and  robust.  For  each  time,  we  need  to  solve  the  advection/dispersion  transport  only 
one  time  in  the  predictor  step,  and  the  chemical  reaction  system  can  be  solved  node  by  node  in  the  corrector 
step.  The  reaction  chemistry  can  be  quite  general.  All  reactions  whose  rates  can  be  described  by  the 
collision  theory  are  included  in  the  model. 

To  improve  the  model,  the  following  work  is  recommended. 

1.  Developing  a  hybrid  flow  scheme  where  the  dynamic,  diffusion,  and  kinematic  wave  models  are 
applied  to  different  parts  of  the  surface  system  adaptively  based  on  a  criterion  that  is  to  be 
established. 

2.  Incorporating  density  effects. 

3.  Incorporating  chemical  equilibrium. 

4.  Modeling  the  existence  of  interstitial  water  associated  with  bed  sediments. 
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Figure  4.1.  The  bottom  elevation  of  Example  1  of  1-D  river/stream  flow. 


Figure  4.2.  Water  depth  at  various  times  for  Example  1  of  1-D  river/stream  flow. 


Figure  4.3.  Discharge  at  various  times  for  Example  1  of  1-D  river/stream  flow. 
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Junction 


Figure  4.4.  River/stream  network  for  Example  2  of 
1-D  river/stream  flow. 


For  the  1-st  reach 


Figure  4.5.  Water  depth  of  Reach  1  at  various  times  for  Example  2  of  1-D  river/stream  flow, 


For  the  2-nd  reach 


Figure  4.6.  Water  depth  of  Reach  2  at  various  times  for  Example  2  of  1-D  river/stream  flow. 
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Figure  4.7.  Water  depth  of  Reach  3  at  various  times  for  Example  2  of  1-D  river/stream  flow. 
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Figure  4.8.  The  contour  of  bottom  elevation  for  Example  1  of  2-D  overland  flow. 
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Figure  4.9.  Discretization  for  Example  1  of  2-D  overland  flow. 
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Figure  4.10.  Water  depth  at  various  times  for  Example  1  of  2-D  overland  flow. 
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Figure  4.1 1.  Comparison  of  water  depth  between  analytical  solutions  and  numerical  results 

for  Example  2  of  2-D  overland  flow. 
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Figure  4.13.  Concentrations  of  the  (a)  the  first,  (b)  the  second,  and  (c)  the  third 
dissolved  chemicals  for  the  example  of  1-D  river/stream  transport. 
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Figure  4.14.  Concentrations  of  (a)  the  first,  (b)  the  second,  and  (c)  the  third 
suspended  sediments  for  the  example  of  1-D  river/stream  transport. 
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Figure  4.16.  Concentrations  of  the  first  particulate  chemical  on  (a)  the  first,  (b)  the  second, 
and  (c)  the  third  suspended  sediments  for  the  example  of  1-D  river/stream  transport. 
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Figure  4.17.  Concentrations  of  the  first  particulate  chemical  on  (a)  the  first,  (b)  the  second, 
and  (c)  the  third  bed  sediments  for  the  example  of  1-D  river/stream  transport. 


Concentration  contour  of  Cl  after  time  =  260 


Figure  4.18.  Concentration  contour  of  the  first  dissolved  chemical  at  time  =  260  s 
for  the  example  of  2-D  overland  transport. 


Concentration  contour  of  C2  after  time  =  260 


Figure  4.19.  Concentration  contour  of  the  second  dissolved  chemical  at  time  =  260 
for  the  example  of  2-D  overland  transport. 


Concentration  contour  of  C3  after  time  =  260 


Figure  4.20.  Concentration  contour  of  the  third  dissolved  chemical  at  time  =  260  s 
for  the  example  of  2-D  overland  transport. 


Concentration  contour  of  C4  after  time  =  260 


Figure  4.21.  Concentration  contour  of  the  fourth  dissolved  chemical  at  time  =  260  s 
for  the  example  of  2-D  overland  transport. 
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Figure  4.22.  Concentration  contour  of  the  fifth  dissolved  chemical  at  time  =  260  s 
for  the  example  of  2-D  overland  transport. 
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Figure  4.23.  Concentration  contour  of  the  sixth  dissolved  chemical  at  time  =  260  s 
for  the  example  of  2-D  overland  transport. 
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Figure  4.24.  Water  depth  at  various  times  for  the  example  of  1-D  river/stream  flow  and 

transport. 


Figure  4.25.  Concentration  of  the  first  dissolved  chemical  at  various  times 
for  the  example  of  1-D  river/stream  flow  and  transport. 


Figure  4.26.  Concentration  of  the  second  dissolved  chemical  at  various  times 
for  the  example  of  1-D  river/stream  flow  and  transport. 


Figure  4.27.  Concentration  of  the  third  dissolved  chemical  at  various  times 
for  the  example  of  1-D  river/stream  flow  and  transport. 


Figure  4.28.  Concentration  of  the  fourth  dissolved  chemical  at  various  times 
for  the  example  of  1-D  river/stream  flow  and  transport. 


Figure  4.29.  Concentration  of  the  fifth  dissolved  chemical  at  various  times 
for  the  example  of  1-D  river/stream  flow  and  transport. 
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Figure  4.30.  Concentration  of  the  sixth  dissolved  chemical  at  various  times 
for  the  example  of  1-D  river/stream  flow  and  transport. 
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Figure  4.31.  Water  depth  at  various  times  for  the  example  of  2-D  overland  flow  and  transport. 
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Figure  4.33.  Concentration  of  the  second  dissolved  chemical  at  various  times 
for  the  example  of  2-D  overland  flow  and  transport. 
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Figure  4.34.  Concentration  of  the  third  dissolved  chemical  at  various  times 
for  the  example  of  2-D  overland  flow  and  transport. 
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Figure  4.35.  Concentration  of  the  fourth  dissolved  chemical  at  various  times 
for  the  example  of  2-D  overland  flow  and  transport. 
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Figure  4.39.  Water  depth  of  1-D  river/stream  at  various  times  for  the  example  of  1-D/2-D  flow. 


Water  Depth  [m].  Time  -  600  s  Water  Depth  [m],  Time  =  1200  s  Water  Depth  [m],  Time  =  2400  s  Water  Depth  [m],  Time  =  3600 


Figure  4.41.  Water  depth  of  2-D  overland  at  various  times  for  the  example  of  1-D/2-D  flow. 
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.  Concentration  of  the  fourth  dissolved  chemical  in  1-D  river/stream  at  various  times 
for  the  example  of  1-D/2-D  flow  and  transport. 


Concentration  of  Cl  [g/m3],  Time  =  1200  s  Concentration  of  Cl  [g/m3],  Time  =  2400  s  Concentration  of  Cl  [g/m3],  Time  =  3600  s 


Concentration  of  the  first  dissolved  chemical  in  2-D  overland  at  various  times 
for  the  example  of  1-D/2-D  flow  and  transport. 


1200  s  Concentration  of  C2  [g/m3],  Time  =  2400  s  Concentration 


Concentration  of  the  second  dissolved  chemical  in  2-D  overland  at  various  times 
for  the  example  of  1-D/2-D  flow  and  transport. 


Concentration  of  C3  [g/m3],  Time  =  1200  s  Concentration  of  C3  [g/m3],  Time  =  2400  s  Concentration  of  C3  [g/m3],  Time  =  3600  s 


-e  4.53.  Concentration  of  the  third  dissolved  chemical  in  2-D  overland  at  various  times 
for  the  example  of  1-D/2-D  flow  and  transport. 


Concentration  of  C4  [g/m3],  Time  =  1200  s  Concentration  of  C4  [g/m3],  Time  =  2400  s  Concentration  of  C4  [g/m3],  Time  =  3600  s 


.54.  Concentration  of  the  fourth  dissolved  chemical  in  2-D  overland  at  various  times 
for  the  example  of  1-D/2-D  flow  and  transport. 


Concentration  of  C5  [g/m3],  Time  =  1200  s  Concentration  of  C5  [g/m3],  Time  =  2400  s  Concentration  of  C5  [g/m3],  Time  =  3600 


Concentration  of  the  fifth  dissolved  chemical  in  2-D  overland  at  various  times 
for  the  example  of  1-D/2-D  flow  and  transport. 


Concentration  of  C6  [g/m3],  Time  =  1200  s  Concentration  of  C6  [g/m3],  Time  =  2400  s  Concentration  of  C6  [g/m3],  Time  =  3600  s 


.56.  Concentration  of  the  sixth  dissolved  chemical  in  2-D  overland  at  various  times 
for  the  example  of  1-D/2-D  flow  and  transport. 
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Figure  4.57.  The  steady-state  solution  of  the  3-D  subsurface  flow  example. 


100  1000 


Figure  4.59.  The  concentration  distribution  of  the  1st  dissolved  chemical 
[g/m3]  at  time  =  60  hour  in  the  3-D  transport  example. 
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Figure  4.60.  The  concentration  distribution  of  the  4th  dissolved  chemical 
[g/m3]  at  time  =  60  hour  in  the  3-D  transport  example. 


Figure  4.62.  The  concentration  distribution  of  the  1st  adsorbed  chemical 
[g/m3]  at  time  =  60  hour  in  the  3-D  transport  example. 


Figure  4.63.  The  domain  and  discretization  of  the  3-D  flow  and  transport  example. 
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Figure  4.65.  The  concentration  distribution  of  the  1st  (or  the  2nd)  dissolved  chemical  [g/m3] 
at  various  times  for  the  3-D  flow  and  transport  example. 


Figure  4.66.  The  concentration  distribution  of  the  3rd  dissolved  chemical  [g/m3] 
at  various  times  for  the  3-D  flow  and  transport  example. 
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Figure  4.68.  The  pressure  head  distribution  on  the  plane  of  y  =  50  m  at  various  times 

for  the  2-D/3-D  flow  example. 
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Figure  4.69.  The  overland  water  depth  distribution  at  various  times  for  the  2-D/3-D 

flow  and  transport  example. 
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Figure  4.71.  The  concentration  distribution  of  dissolved  chemicals  [g/m3]  on  2-D  overland 
at  time  =  6  hours  for  the  2-D/3-D  flow  and  transport  example. 


Figure  4.72.  The  concentration  distribution  of  dissolved  chemicals  [g/m3]  on  the  y  =  50  m 
vertical  plane  of  3-D  subsurface  at  time  =  6  hours  for  the  2-D/3-D  flow  and  transport  example. 


DEPTH 


Figure  4.76.  The  pressure  head  distribution  on  four  vertical  planes  at  various  times 

for  the  1-D/2-D/3-D  flow  example. 


Figure  4.77.  The  Darcy  velocity  (specific  discharge)  on  four  vertical  planes  at  various  times 

for  the  1-D/2-D/3-D  flow  example. 
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Figure  4.78.  The  river/stream  water  depth  at  various  times  for  the  1-D/2-D/3-D 

flow  and  transport  example. 


Figure  4.79.  The  overland  water  depth  at  various  times  for  the  1-D/2-D/3-D 

flow  and  transport  example. 


Figure  4.80.  The  pressure  head  distribution  at  various  times  for  the  1-D/2-D/3-D 

flow  and  transport  example. 
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at  Time  =  12  hours  for  the  1-D/2-D/3-D  flow  and  transport  example. 


g/m3]  on  overland 


Figure  4.83.  The  concentration  distribution  of  dissolved 
chemicals  [g/m3]  in  the  subsurface  at  Time  =  12  hours  for  the 
1-D/2-D/3-D  flow  and  transport  example. 
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Figure  4.87.  The  concentration  distribution  of  particulate  chemicals  on  overland 
at  Time  =12  hours  for  the  1-D/2-D/3-D  flow  and  transport  example. 


Figure  4.88.  The  concentration  distribution  of  the  adsorbing  site  and  adsorbed  chemicals  [g/m3] 
in  the  subsurface  at  Time  =12  hours  for  the  1-D/2-D/3-D  flow  and  transport  example. 


Appendixl.  DATA  INPUT  GUIDE 


This  data  input  guide  is  composed  of  eleven  files:  three  for  3-D  subsurface  flow/transport,  three  for 
2-D  overland  flow/transport,  three  for  1-D  river/stream  flow/transport,  one  for  chemical/sediment 
information  and  one  for  1-D/2-D/3-D  mapping.  They  are  described  as  follows. 

1.1.  File  1:  3-D  subsurface  geometry  file  (3dm) 


Value 

Description 

WMS3DM 

File  type  identifier 

T1-T3  Cards 

Job  title 

Only  one  Tl,  T2,  and  T3  card  can  be  used. 

GECard 

Mesh  card 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

GE 

Card  group  identifier 

C  3 

IC3 

8 

Hexahedral  element.  One  entry  for  each  hexahedral  element  in  the  mesh. 

1 

M 

+ 

id  of  global  element. 

2 

IE(M,1) 

+ 

id  of  the  global  node  that  serves  as  the  1st  element  node  of  the  global 
element. 

3 

IE(M,2) 

+ 

id  of  the  global  node  that  serves  as  the  2nd  element  node  of  the  global 
element. 

4 

IE(M,3) 

+ 

id  of  the  global  node  that  serves  as  the  3rd  element  node  of  the  global 
element. 

5 

IE(M,4) 

+ 

id  of  the  global  node  that  serves  as  the  4th  element  node  of  the  global 
element. 

6 

IE(M,5) 

+ 

id  of  the  global  node  that  serves  as  the  5th  element  node  of  the  global 
element. 

7 

IE(M,6) 

+ 

id  of  the  global  node  that  serves  as  the  6th  element  node  of  the  global 
element. 

8 

IE(M,7) 

+ 

id  of  the  global  node  that  serves  as  the  7th  element  node  of  the  global 
element. 

9 

IE(M,8) 

+ 

id  of  the  global  node  that  serves  as  the  8th  element  node  of  the  global 
element. 

10 

IE(M,9) 

+ 

The  material  ID  of  this  element. 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

GE 

Card  group  identifier 

C  3 

IC3 

6 

Wedge  or  prism  element.  One  entry  for  each  wedge  element  in  the  mesh. 

1 

M 

+ 

id  of  global  element. 

2 

IE(M,1) 

+ 

id  of  the  global  node  that  serves  as  the  1st  element  node  of  the  global 
element. 

3 

IE(M,2) 

+ 

id  of  the  global  node  that  serves  as  the  2nd  element  node  of  the  global 
element. 

4 

IE(M,3) 

+ 

id  of  the  global  node  that  serves  as  the  3rd  element  node  of  the  global 
element. 
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5 


IE(M,4) 


6  IE(M,5) 

7  E(M,6) 

8  IE(M,9) 


+  id  of  the  global  node  that  serves  as  the  4th  element  node  of  the  global 
element. 

+  id  of  the  global  node  that  serves  as  the  5th  element  node  of  the  global 
element. 

+  id  of  the  global  node  that  serves  as  the  6th  element  node  of  the  global 
element. 

+  The  material  ID  of  this  element. 


Field  Variable 
C  1-2  IC1 
C  3  IC3 

1  M 

2  E(M,1) 

3  E(M,2) 

4  E(M,3) 

5  E(M,4) 

10  E(M,9) 


Value  Description 

GE  Card  group  identifier 

4  Tetrahedral  element.  One  entry  for  each  tetrahedral  element  in  the  mesh. 

+  id  of  global  element. 

+  id  of  the  global  node  that  serves  as  the  1st  element  node  of  the  global 
element. 

+  id  of  the  global  node  that  serves  as  the  2nd  element  node  of  the  global 
element. 

+  id  of  the  global  node  that  serves  as  the  3rd  element  node  of  the  global 
element. 

+  id  of  the  global  node  that  serves  as  the  4th  element  node  of  the  global 
element. 

+  The  material  ID  of  this  element. 


GN  Card 

Field 

Variable 

C  1-2 

IC1 

1 

NP 

2 

X(NP,1) 

3 

X(NP,2) 

4 

X(NP,3) 

Mesh  node 

Value  Description 

GN  Card  group  identifier 

Mesh  node.  One  entry  for  each  node  in  the  mesh. 
+  id  of  global  node. 

±  The  x  coordinate  of  the  node  [L]. 

±  The  y  coordinate  of  the  node  [L]. 

±  The  z  coordinate  of  the  node  [L]. 


EN  Card  End  card 

Field  Variable  Value  Description 

C 1-2  IC1  EN  Card  group  identifier 

C  3  IC3  D  End  of  input  data  marker 


13,.  File  2:  2-D  overland  geometry  file  (.2dm) 

Value  Description 

WMS2DM  File  type  identifier 

T1-T3  Cards  Job  title 

Only  one  Tl,  T2,  and  T3  card  can  be  used. 

GE  Card  Element  information 

Field  Variable  Value  Description 

C 1-2  IC1  GE  Card  group  identifier. 
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C  3 

IC3 

3 

Identification  of  element. 

A  triangular  element  is  being  input. 

4 

A  quadrilateral  element  is  being  input. 

1 

M 

+ 

id  of  global  element. 

2 

IE1(M,1) 

+ 

id  of  the  global  node  that  serves  as  the  1st  element  node  of  the  : 
element. 

3 

IE2(M,2) 

+ 

id  of  the  global  node  that  serves  as  the  2nd  element  node  of  the 
global  element. 

4 

IE2(M,3) 

+ 

id  of  the  global  node  that  serves  as  the  3rd  element  node  of  the 
global  element. 

5 

IE2(M,4) 

+ 

id  of  the  global  node  that  serves  as  the  4*  element  node  of  the 
global  element.  It  is  zero  for  a  triangular  element. 

6 

IE2(M,5) 

+ 

id  of  the  material  type  of  the  global  element. 

GN  Card 

Node  information 

Field 

Variable 

Value 

Descriotion 

C  1-2 

IC1 

GN 

Card  group  identifier. 

C  3 

IC3 

blank. 

1 

N 

+ 

id  of  global  node.. 

2 

X2(N,1) 

± 

The  x-coordinate  of  the  global  node  [L], 

3 

X2(N,2) 

± 

The  y-coordinate  of  the  global  node  [L]. 

4 

X2(N,3) 

± 

The  z-coordinate  (bottom  elevation)  of  the  global  node  [L]. 

ENCard 

End  of  data  control 

Field 

Variable 

Value 

Description 

Cl-2 

IC1 

EN 

Card  group  identifier. 

C  3 

IC3 

D 

End  of  input  data. 

13.  File  3: 1-D  river/stream  geometry  file  (.1dm) 

Value 

Description 

WMS1DM 

File  type  identifier 

T1-T3  Cards 

Job  title 

Only  one  Tl,  T2,  and  T3  card  can  be  used. 

GE  Card 

Element  information 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

GE 

Card  group  identifier. 

C  3 

IC3 

2 

Identification  of  element. 

1 

M 

+ 

id  of  global  element. 

2 

IE1(M,1) 

+ 

id  of  the  global  node  that  serves  as  the  1st  element  node  of  the 
global  element. 

3 

IE1(M,2) 

+ 

id  of  the  global  node  that  serves  as  the  2nd  element  node  of  the 
global  element. 

4 

IE1(M,3) 

+ 

id  of  the  material  type  of  the  global  element. 
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GN  Card 
Field  Variable 
C  1-2  IC1 
C  3  IC3 

1  N 

2  X1(N,1) 

3  X1(N,2) 


Node  information 
Value  Description 
GN  Card  group  identifier, 

blank 

+  id  of  Global  node. 

+  The  x-coordinate  of  the  global  node  [L]. 

+  The  z-coordinate  (bottom  elevation)  of  the  global  node  [L]. 


EN  Card  End  of  data  control 

Field  Variable  Value  Description 

Cl-2  IC1  EN  Card  group  identifier. 

C  3  IC3  D  End  of  input  data. 


1.4.  File  4: 3-D  subsurface  flow  file  (3bc  file) 

Value  Description 

WMS3BC  File  type  identifier 

T1-T3  Cards  Job  title 

Only  one  Tl,  T2,  and  T3  card  can  be  used. 

OP  Card  Run  option  parameters 


Field 

Variable 

Value 

Description 

C  1-2 

IC1 

OP 

Card  group  identifier 

C  3 

IC3 

1 

Specify  the  type  of  simulation; 

1 

KMOD 

Index  of  subsurface  simulation. 

0 

No  subsurface  simulation. 

1 

Only  flow  is  simulated. 

2 

Both  flow  and  transport  are  simulated. 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

OP 

Card  group  identifier 

C  3 

IC3 

2 

Solver  options. 

1 

KSSF 

0 

Steady-state  flow  simulation. 

1 

Transient  flow  simulation; 

2 

ILUMP 

0 

No  mass  lumping. 

1 

Mass  lumping. 

3 

IPNTSF 

Matrix  solver  for  flow  simulations. 

1 

The  pointwise  iterative  matrix  solver 

2 

Preconditioned  Conjugate  Gradient  Method  (polynomial). 

3 

Preconditioned  Conjugate  Gradient  Method  (Incomplete  Cholesky). 

4 

IQUAR 

Index  of  using  quadrature  for  numerical  integration. 

11 

Nodal  quadrature  for  the  integration  of  an  element  face  and  an  element. 

12 

Nodal  quadrature  for  the  integration  of  an  element  face,  Gaussian  quadrature 

for  the  integration  of  an  element. 

21 

Gaussian  quadrature  for  the  integration  of  an  element  face.  Nodal  quadrature 

for  the  integration  of  an  element. 
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22 

Gaussian  quadrature  for  the  integration  of  an  element  face  and  an  element. 

5 

IMODEL 

-10 

Index  of  simulating  subsurface  flow. 

The  flow  equation  is  not  solved.  Rather,  the  pressure  (total)  head,  Darcy 
velocity  (specific  discharge),  and  moisture  content  are  given  through  the 
input  of  initial  conditions. 

Otherwise 

The  flow  equation  is  solved  by  using  the  Gelarkin  finite  element  method. 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

OP 

Card  group  identifier 

C  3 

IC3 

3 

Weighting  factor  for  flow  simulations; 

1 

WF 

0.5 

Time  derivative  weighting  factor  for  flow  simulations. 

Crank-Nicolson  central 

1.0 

Backward  difference 

2 

OMEF 

0.0-1.0 

Iteration  parameter  for  solving  nonlinear  matrix  equations. 

Under  relaxation, 

1.0 

Exact  relaxation. 

1. 0-2.0 

Over  relaxation. 

3 

OMIF 

0.0-1. 0 

Iteration  parameter  for  solving  linearized  matrix  equation  pointwise. 
Under  relaxation. 

1.0 

Exact  relaxation. 

1. 0-2.0 

Over  relaxation. 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

OP 

Card  group  identifier 

C  3 

IC3 

4 

Index  for  analytical  soil  characteristic  function  KSP; 

1 

KSP 

0 

KSP  =  0  is  an  index  for  providing  an  analytical  soil  characteristic  function 
.The  default  value  is  1. 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

OP 

Card  group  identifier 

C  3 

IC3 

5 

Parameters  for  Preconditioned  Conjugate  Gradient  method; 

1 

EIGEN 

0 

GG  will  not  be  read. 

1 

GG  will  be  read. 

2 

GG 

+ 

Upper  bound  of  the  maximum  eigenvalue  of  the  coefficient 
matrix  used  in  the  Preconditioned  Conjugate  Gradient  method. 

IP  Card 

Iteration  Parameters 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

IP 

Card  group  identifier 

C  3 

IC3 

1 

Iteration  parameters  for  solving  flow  equations 

1 

NITERF 

+ 

Number  of  iterations  allowed  for  solving  the  non-linear  flow  equation. 

2 

NCYLF 

+ 

Number  of  cycles  permitted  for  iterating  rainfall  seepage  boundary  condition 
or  the  boundary  condition  on  the  interface  between  2-D  overland  and  3-D 
subsurface  regimes  per  time  step. 

3 

NPITERF 

+ 

Number  of  iterations  permitted  for  solving  the  linearized  flow  equations 
,  i.e.,  this  value  is  used  in  matrix  solver. 

4 

TOLAF 

+ 

The  convergent  criteria  for  the  implementation  of  iteration  scheme  in  the 
steady-state  flow  simulation  [L]. 
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5 


TOLBF 


The  convergent  criteria  for  the  implementation  of  iteration  scheme  in  the 
transient-state  flow  simulation  [L]. 

V_CUT  +  Cut-off  of  velocity  [L/T].  If  the  computed  velocity  issmaller  than  this  value 

,  it  is  set  to  zero. 


TC  Card 

Iteration  Parameters 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

TC 

Card  group  identifier 

C  3 

IC3 

1 

Total  simulation  time  and  fixed  time  step  size. 

1 

TMAX 

+ 

Maximum  simulation  time  [TJ. 

2 

DELT 

+ 

Initial  time  step  size  for  flow  [T]. 

3 

DELTT 

+ 

Time  step  size  for  transport  [T], 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

TC 

Card  group  identifier. 

C  3 

IC3 

2 

Computational  time  step. 

1 

IDTXY 

+ 

Index  of  xy  series  for  variable  time  step. 

OC  Card 

OutDUt 

control  parameters 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

OC 

Card  group  identifier 

C  3 

IC3 

1 

Print  control  parameters. 

1 

IBUG 

0 

Do  not  print  the  diagnostic  output. 

1 

Do  print  the  diagnostic  output. 

2 

ICHNG 

0 

Do  not  print  cyclic  change  of  rainfall/seepage  nodes  or  of  ground  surface 

nodes. 

1 

Print  cyclic  change  of  rainfall/seepage  nodes  or  of  ground  surface  nodes. 

3 

JOPT 

0 

Print  at  specified  interval. 

1 

Print  at  specified  set  of  time  values. 

4 

KPRT 

+ 

Specify  the  interval  if  JOPT  =  0, 

NPRINT 

+ 

Specify  total  number  of  the  specified  times,  if  JOPT=l, 

(new  line) 

+ 

After  OCl  card,  specify  the  times,  if  JOPT  =  1.  One  data  entry  per  line. 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

OC 

Card  group  identifier 

C  3 

IC3 

2 

Print  options. 

1 

NSELT 

+ 

Total  options  to  be  selected. 

2 

KPRO(i) 

Print  options. 

1 

Print  total  head. 

2 

Print  pressure  head. 

3 

Print  Darcy  velocity  (specific  discharge). 

4 

Print  nodal  moisture  content. 

5 

Print  concentration. 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

OC 

Card  group  identifier 

C  3 

IC3 

3 

Output  control  for  post-process. 

1 

IFILE 

0 

Save  as  ASCII  test  format. 
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1 

Save  as  binary  format. 

2 

KOPT 

0 

Save  at  specified  interval. 

1 

Save  at  specified  set  of  times. 

3 

KDSK 

+ 

Save  every  specified  interval,  if  KOPT=0. 

KPOST 

+ 

Save  at  specified  set  of  times,  if  KOPT=l. 

(new  line) 

+ 

After  OC3  card,  specify  the  times,  if  KOPT  =  1.  One  data  entry  per  line 

,  up  to  KPOST  times. 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

OC 

Card  group  identifier 

C  3 

IC3 

4 

Solution  file  output  options. 

1 

KSELT 

+ 

Total  options  to  be  selected. 

2 

KSAVE(i) 

0 

Save  options. 

Save  nothing. 

1 

Save  pressure  head. 

3 

Save  nodal  moisture  content. 

4 

Save  velocity. 

5 

Save  concentration. 

MP  Card 

Material  Drooertv  parameters 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

MP 

Card  group  identifier 

C  3 

IC3 

1 

Index  of  hydraulic  conductivity  or  permeability. 

1 

KCP 

0 

Hydraulic  conductivity. 

1 

Permeability. 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

MP 

Card  group  identifier 

C  3 

IC3 

2 

Hydraulic  conductivity  or  permeability  tensor. 

1 

I 

+ 

Material  ID. 

2 

PROPF(l,I) 

+ 

Saturated  xx  hydraulic  conductivity,  Kxx  [L/T],  or  saturated  permeability 
[L2]  of  the  medium  I. 

3 

PROPF(2,I) 

+ 

Saturated  yy  hydraulic  conductivity,  Kyy  [L/T],  or  saturated  permeability 
[L2]  of  the  medium  I. 

4 

PROPF(3,I) 

+ 

Saturated  zz  hydraulic  conductivity  Kzz  [L/T],  or  saturated  permeability  [L2 
]  of  the  medium  I. 

5 

PROPF(4,I) 

+ 

Saturated  xy  hydraulic  conductivity  Kxy  [L/T],  or  saturated  permeability 
[L2]  of  the  medium  I. 

6 

PROPF(5,I) 

+ 

Saturated  xz  hydraulic  conductivity  Kxz  [L/T],  or  saturated  permeability 
[L2]  of  the  medium  I. 

7 

PROPF(6,I) 

+ 

Saturated  yz  hydraulic  conductivity  Kyz  [L/T],  or  saturated  permeability 
[L2]  of  the  medium  I. 

8 

PROPF(9,I) 

+ 

The  effective  porosity  of  the  medium  L  ne  [L3/L3]. 

Field 

Variable 

Value 

Descrmtion 

C  1-2 

IC1 

MP 

Card  group  identifier 

C  3 

IC3 

3 

Density  and  viscosity  of  fresh  water. 

1 

rruNiT 

Index  of  time  unit. 
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1 

The  time  unit  for  simulation  is  second. 

2 

The  time  unit  for  simulation  is  minute. 

3 

The  time  unit  for  simulation  is  hour. 

2 

ILUNTT 

1 

Index  of  length  unit. 

The  length  unit  for  simulation  is  meter. 

2 

The  length  unit  for  simulation  is  foot. 

3 

The  length  unit  for  simulation  is  kilometer. 

4 

The  length  unit  for  simulation  is  mile. 

3 

RHO 

+ 

Density  of  fresh  water  [M/L3]. 

4 

vise 

+ 

Dynamic  viscosity  of  water  [M/L/T]. 

SPCard 

Soil  property  parameters  for  unsaturated  zone 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

SP 

Card  group  identifier 

C  3 

IC3 

1 

Soil  property  functions 

1 

i 

+ 

Material  type  ID. 

2 

IHM(i) 

+ 

Index  of  moisture  content  vs.  pressure  head  xy  series. 

3 

MC(i) 

+ 

Index  of  relative  hydraulic  conductivity  vs.  pressure  head  xy  series. 

4 

IHW(i) 

+ 

Index  of  water  capacity  vs.  pressure  head  xy  series. 

5 

HCON(i) 

+ 

The  ponding  depth  associated  with  the  i*  material. 

6 

HMIN(i) 

± 

The  minimum  pressure  head  associated  with  the  i*  material. 

Note: 

This  information  is  a  MUST  to  perform  subsurface  simulations. 

PS  Card 

Point  source/sink  parameters 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

PS 

Card  group  identifier 

C  3 

IC3 

1 

Point  source/sink  flow  rate  for  both  flow  and  transport  simulation. 

1 

NPWF(I) 

+ 

Node  number  of  the  Ith  point  source/sink. 

2 

IWTYPF(I) 

+ 

Index  of  the  flow  rate  xy  series. 

DB  Card 

Dirichlet  boundary  parameters 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

DB 

Card  group  identifier 

C3 

IC3 

1 

Dirichlet  boundary  conditions,  prescribed  total  head  for  flow  simulation. 

1 

NPDBF(I) 

+ 

Global  node  number  of  the  Ith  Dirichlet  boundary. 

2 

IDTYPF(I) 

+ 

Index  of  the  head  xy  series. 

3 

IDHB(I) 

0 

Index  of  the  profile  type  for  the  j*  Dirichlet  boundary  node. 

This  profile  is  a  time-dependent  pressure  head  profile. 

1 

This  profile  is  a  time-dependent  total  head  profile. 

CB  Card 

Cauch\ 

’  boundary  parameters 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

CB 

Card  group  identifier 

C3 

IC3 

1 

Cauchy  boundary  conditions,  prescribed  flow  flux  rate  for  flow  simulation. 

1 

M 

+ 

Element  number  of  the  Cauchy  boundary. 

2 

IDCF(I) 

+ 

Element  face  ID  of  this  boundary  side. 

3 

ICTYPF(I) 

+ 

Index  of  the  flux  rate  xy  series. 
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NB  Card 

Neumann  boundary  parameters 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

NB 

Card  group  identifier 

C  3 

IC3 

1 

Neumann  boundary  conditions,  prescribed  flow  flux  rate  (due  to  pressure 

head  difference)  for  flow  simulation. 

1 

M 

+ 

Element  number  of  the  Neumann  boundary. 

2 

IDNF(I) 

+ 

Element  face  ID  of  this  boundary  side. 

3 

INTYPF(I) 

+ 

Index  of  the  flux  rate  xy  series. 

RS  Card 

Variable  boundary  parameters 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

RS 

Card  group  identifier 

C3 

IC3 

1 

Variable  boundary  condition,  rainfall/evaporation/seepage  flux  rate  for  flow 

simulation. 

1 

M 

+ 

Element  number  of  the  rainfall/seepage  boundary. 

2 

IDRF(I) 

+ 

Element  face  ID  of  this  boundary  side. 

3 

IVTYPF(I) 

+ 

Index  number  of  rainfall/evaporation  time  series  for  the  element  face. 

IC  Card 

Initial  condition  data  parameters 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

IC 

Card  group  identifier 

C  3 

IC3 

S 

Initial  condition  start  type. 

1 

ISTART 

0 

Cold  start. 

1 

Hot  start. 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

IC 

Card  group  identifier 

C  3 

IC3 

T 

Initial  condition  hot  start  time. 

1 

HSTIME 

+ 

Time  corresponding  for  the  hot  start. 
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4. 


4 


2 


1 -4-3-2 
5-6-7-8 

1 - 2-6-5 

2- 3-7-6 

3- 4-8-7 

4- 1-5-8 


Triangular  Prism  Element: 


Face  Nodes 


1 

2 

3 

4 

5 


1-3-2 

4-5-6 

1 - 2-5-4 

2- 3-6-5 

3- 1-4-6 


Tetrahedral  Element: 

Face 

Nodes 

1 

2-3-4 

2 

1-4-3 

3 

1-2-4 

4 

1-3-2 

Figure  1.1  Specification  of  3-D  element  sides. 


Field 

Variable 

Value 

Description 

C  1-2 

IC1 

IC 

Card  group  identifier 

C  3 

IC3 

H 

Constant  or  variable  initial  total  head. 

1 

MEAD 

0 

Constant  total  head. 

1 

Spatially  variable  total  head  (if  ©HEAD  =  1)  or  pressure  head  (if  ©HEAD 
=  0). 

2 

©HEAD 

0 

Initial  pressure  head  is  to  input. 

1 

Initial  total  head  is  to  input. 

2 

HCONST 

± 

If  IHEAD=0,  the  constant  head  value.  Otherwise,  omit. 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

IC 

Card  group  identifier 

C3 

IC3 

U 

Constant  or  variable  initial  velocity. 

1 

IVEL 

0 

Constant  velocity. 

1 

Spatially  variable  velocity. 

2 

UCONST 

± 

If  ]VEL=0,  the  x-velocity.  Otherwise,  omit. 

3 

VCONST 

± 

If  IVEL=0,  the  y-velocity.  Otherwise,  omit. 

4 

WCONST 

+ 

If  IVEL=0,  the  z-velocity.  Otherwise,  omit. 

Note:  This  card  is  a  MUST  when  IMODEL  =  -10  (i.e.,  the  flow  is  not  to  be  computed). 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

IC 

Card  group  identifier 

C3 

IC3 

M 

Constant  or  variable  initial  moisture  content. 

1 

IMOIS 

0 

Constant  moisture  content. 

1 

Spatially  variable  moisture  content. 

2 

THCNST 

± 

If  IMOIS=0,  the  moisture  content  value.  Otherwise,  omit. 

Note:  This  card  is  a 

MUST  only  when  IMODEL  =  -10  (i.e.,  the  flow  is  not  to  be  computed). 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

IC 

Card  group  identifier 

C  3 

IC3 

F 

Initial  condition  file  format. 

1 

ICFTLE 

0 

The  initial  condition  files  are  in  text  format. 

1 

The  initial  condition  files  are  in  binary  format. 

2 

IVF1LE 

0 

The  initial  flow  files  are  in  text  format. 

1 

The  initial  flow  files  are  in  binary  format. 

3 

IFFU 

0 

How  files  contain  a  steady-state  solution. 

1 

How  files  contain  a  transient  solution. 

XYCard 

X-Y  Series  Parameters 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

XY 

Card  group  identifier 

C  3 

IC3 

1 

Generation  of  any  x-y  series  function. 

1 

i 

+ 

Index  number  for  x-y  series. 

2 

NPOINT(i) 

+ 

The  number  of  x-y  values  in  the  series. 

3 

DELTAX 

0 

Dummy  values. 

4 

DELTAY 

0 

Dummy  values. 
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5  REPEAT  0  Dummy  values. 

6  BEGCYC  0  Dummy  values. 

7  TNAME  +  A  character  string  representing  the  name  of  the  XY  series. 

(new  line)X,Y  ±,±  After  XY  card,  the  x-y  values  of  the  series  are  listed  one  pair  per  line  up 

to  NPOINT(i). 

EN  Card  End  of  data  control 

Field  Variable  Value  Description 

Cl-2  IC1  EN  Card  group  identifier 

C  3  IC3  D  End  of  input  data 


1.5.  File  5: 2-D  overland  flow  file  (.2bc  file) 

Value  Description 

WMS2BC  File  type  identifier 

T1-T3  Cards  Job  title 

Only  one  Tl,  T2,  and  T3  card  can  be  used. 


OP  Card 
Field  Variable 
C  1-2  IC1 
C  3  IC3 
1  KMOD 


OP  Card  group  identifier. 


1  Simulation  selection. 


Index  of  river/stream  simulation. 


0  No  river/stream  simulation. 


1  Only  flow  is  simulated. 

2  Both  flow  and  transport  are  simulated. 


Field 

Variable 

Value 

Description 

Cl-2 

IC1 

OP 

Card  group  identifier. 

C  3 

IC3 

2 

Solver  specification. 

1 

ILUMP 

Index  of  using  mass  lumping. 

0 

No  mass  lumping. 

1 

Mass  lumping. 

2 

IPNTS 

Index  of  using  linear  matrix  solver  for  flow  simulations. 

1 

The  pointwise  iterative  matrix  solver. 

2 

Preconditioned  Conjugate  Gradient  Method  (polynomial). 

3 

Preconditioned  Conjugate  Gradient  Method  (Incomplete  Cholesky). 

3 

IQUAR 

Index  of  using  quadrature  for  numerical  integration. 

1 

Nodal  quadrature  for  line  element  integration. 

2 

Gaussian  quadrature  for  line  element  integration. 

4 

IDIFF 

Index  of  taking  into  account  the  eddy  viscosity  terms. 

1 

Yes. 

0 

No,  the  eddy  viscosity  terms  are  neglected. 

5 

IALLOW 

Index  of  allowing  the  simulation  to  continue  when  there  is  no 

convergence  reached  for  the  non-linear  iteration. 
1  Yes. 
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0 


6 


No. 

IMODEL  Index  of  simulating  overland  flow. 

3  Using  MOC  to  solve  the  dynamic  model  only. 

2  Using  the  diffusion  model  only. 

1  Using  the  kinematic  model  only. 

-10  Specifying  water  depth  and  flow  velocity  with  the  initial  condition.  The 
flow  equation  is  not  solved. 


Field 

Variable 

Value 

Description 

C  1-2 

IC1 

OP 

Card  group  identifier. 

C  3 

IC3 

3 

Weighting  factor  for  simulations. 

1 

W 

0.5 

Time  derivative  weighting  factor  for  flow  simulation. 

Crank-Nicolson  central. 

1.0 

Backward  difference. 

2 

OME 

Relaxation  parameter  for  solving  nonlinear  matrix  equations. 

0.0- 1.0  Under  relaxation. 

1.0 

Exact  relaxation. 

1. 0-2.0  Over  relaxation. 

3 

OMI 

Relaxation  parameter  for  solving  linearized  matrix  equation. 

0.0-1. 0  Under  relaxation. 

1.0 

Exact  relaxation. 

1. 0-2.0  Over  relaxation. 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

OP 

Card  group  identifier. 

C  3 

IC3 

4 

Preconditioned  Conjugate  Gradient  method. 

1 

IEIGEN 

0 

GG  will  not  be  read. 

1 

GG  will  be  read. 

2 

GG 

+ 

Upper  bound  of  the  maximum  eigenvalue  of  the  coefficient 
matrix  used  in  the  Preconditioned  Conjugate  Gradient  method. 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

OP 

Card  group  identifier. 

C  3 

IC3 

5 

Method  of  characteristics. 

1 

ISK 

-1 

Index  of  choosing  the  directions  of  characteristics. 

Using  the  velocity  direction  as  the  direction  of  characteristics. 

0 

Solve  the  diagonalization  equations  for  the  directions. 

1 

Specify  directions  by  users. 

2 

ANGLE  1 

+ 

User  specified  angle  (in  degree)  for  the  direction  of  the  first  characteristic 
.(COS(ANGLEl),  SIN(ANGLEl))  is  the  direction. 

3 

ANGLE2 

+ 

User  specified  angle  (in  degree)  for  the  second  and  third  characteristics 
.(COS(ANGLE2),  SIN(ANGLE2))  is  the  direction. 

IP  Card 

Iteration  Parameters 

Field 

Variable 

Value 

Descrmtion 

C  1-2 

IC1 

IP 

Card  group  identifier. 

C  3 

IC3 

1 

Total  simulation  time. 

1 

NNTTER 

+ 

Allowed  number  for  the  non-linear  iteration  in  the  flow  simulation. 
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2 

NPITER 

+ 

Allowed  number  for  the  linearized  iteration  in  the  flow  simulation. 

3 

TOLBH 

+ 

Allowed  relative  error  for  water  depth. 

4 

TOLBV 

+ 

Allowed  relative  error  for  velocity  components. 

5 

V_CUT 

+ 

Cut-off  of  velocity  [L/T].  If  the  computed  velocity  is  smaller  than  this  value. 

it  is  set  to  zero. 

Multiplication  factor  to  set  the  allowed  mean  square  root  errors,  BHMSR 

6 

FMSR 

+ 

for  water  depth  and  BVMSR  for  velocity,  where  BHMSR  = 
TOLBH*FMSR;  BVMSR  =  TOLBV*FMSR. 


PT  Card 

Time  marchine  oarameters 

Field 

Variable 

Value 

Descritrtion 

C  1-2 

IC1 

PT 

Card  group  identifier. 

C  3 

IC3 

1 

Total  simulation  time. 

1 

NXW 

+ 

Subelement  number  in  one  direction  that  is  used  in  the  “in-element”  particle 
tracking.  The  total  subelement  number  included  in  one  global  element  is 
NXW*NXW. 

2 

IDETQ 

1 

Index  of  particle  tracking  approach. 

Using  the  average-velocity  approach. 

2 

Using  the  constant-velocity  approach. 

TC  Card 

Iteration  Parameters 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

TC 

Card  group  identifier. 

C  3 

IC3 

1 

Total  simulation  time. 

1 

TMAX 

+ 

Maximum  simulation  time  [T]. 

2 

DELT 

+ 

Initial  time  step  size  [T]. 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

TC 

Card  group  identifier. 

C  3 

IC3 

2 

Computational  time  step. 

1 

IDTXY 

+ 

Index  of  xy  series  for  variable  time  step. 

OC  Card 

Output  control  Darameters 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

OC 

Card  group  identifier. 

C  3 

IC3 

1 

Print  control  parameters. 

1 

IBUG 

0 

Do  not  print  the  diagnostic  output. 

1 

Do  print  the  diagnostic  output. 

2 

JOPT 

0 

Print  at  specified  intervals. 

1 

Print  at  specified  set  of  time  values. 

3 

KPRT 

+ 

Specify  the  interval  if  JOPT  =  0. 

NPRINT 

+ 

Specify  total  number  of  the  specified  times,  if  JOPT=l. 

Note:  NPRINT  new  lines  after  OCl  card  are  needed  if  JOPT  =  1. 

(the  first  new  line) 

1  TPRT(  1 )  +  The  1st  specified  time  moment  at  which  the  associated  simulation  results  are 

to  be  printed. 

(the  second  new  line) 
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1  TPRT(2)  +  The  2nd  specified  time  moment  at  which  the  associated  simulation  results 

are  to  be  printed. 

(the  NPRINT  new  line) 

1  TPRT (NPRINT)  +  The  NPRINT*  specified  time  moment  at  which  the  associated  simulation 

results  are  to  be  printed. 

Field  Variable 
C  1-2  IC1 
C  3  IC3 

1  NSELT 

2  KPRO(i) 


Field  Variable  Value  Description 

C 1-2  IC1  OC  Card  group  identifier. 

C  3  IC3  3  Output  control  for  post-process. 

1  IFILE  0  Save  as  ascii  format. 

1  Save  as  binary  format. 

2  KOPT  0  Save  at  specified  interval. 

1  Save  at  specified  set  of  times. 

3  KDSK  +  Save  every  specified  interval,  if  KOPT=0. 

NPOST  +  Save  at  specified  set  of  times,  if  KOPT=l . 

Note:  NPOST  new  lines  after  OC3  card  are  needed  if  KOPT  =  1 . 

(the  first  new  line) 

1  TSV(l)  +  The  1st  specified  time  moment  at  which  the  associated  simulation  results  are 

to  be  saved. 

(the  second  new  line) 

1  TSV(2)  +  The  2nd  specified  time  moment  at  which  the  associated  simulation  results 

are  to  be  saved. 

(the  NPOST  new  line) 

1  TSV(NPOST)  +  The  NPOST*  specified  time  moment  at  which  the  associated  simulation 

results  are  to  be  saved. 

Field  Variable  Value 

C  1-2  IC1  OC 

C  3  IC3  4 

1  KSELT  + 

2  KSAVE(i) 

1 

2 
3 


Description 
Card  group  identifier. 
Solution  file  output  options. 
Total  options  to  be  selected. 
Save  options. 

Save  water  depth. 

Save  flux. 

Save  infiltration  rate. 


Value  Description 
OC  Card  group  identifier 
2  Print  options. 

+  Total  options  to  be  selected. 

Print  options. 

1  Print  water  depth. 

2  Print  velocity. 

3  Print  concentration. 


GC  Card 


Cross  section  parameters 
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Field  Variable  Value  Description 

C 1-2  IC1  GC  Card  group  identifier. 

C  3  IC3  1  Generate  cross  section  to  calculate  discharge. 

1  NGCL  +  Total  number  of  cross  sections. 

Field  Variable  Value  Description 

C 1-2  IC1  GC  Card  group  identifier. 

C  3  IC3  2  Cross  section  information. 

1  id  +  Index  number  of  cross  section. 

2  NPL  +  Number  of  nodal  points  in  the  x-section. 

(new  line)  +  Node  points. 

Field  Variable  Value  Description 

C 1-2  IC1  GC  Card  group  identifier. 

C3  IC3  3  Save  and  print  hydrograph. 

1  LOPT  0  Save  and  print  at  specified  interval. 

1  Save  and  print  at  specified  set  of  times. 

2  LDSK  0  Save  and  print  at  specified  interval. 

+  Save  and  print  every  specified  interval,  if  LOPT=0. 

LPOST  +  Save  and  print  at  specified  set  of  times,  if  LOPT=l . 

Note:  LPOST  new  lines  after  GC3  card  are  needed  if  LOPT  =  1 . 

(the  first  new  line) 

1  TSA(l)  +  The  1st  specified  time  moment  at  which  the  associated  hydrographs  are  to 

be  saved. 

(the  second  new  line) 

1  TSA(2)  +  The  2nd  specified  time  moment  at  which  the  associated  hydrographs  are  to 

be  saved. 

(the  NPOST  new  line) 

1  TSA(LPOST)  +  The  LPOSTth  specified  time  moment  at  which  the  associated  hydrographs 

are  to  be  saved. 

(new  line)  +  After  GC3  card,  specify  the  times,  if  LOPT  =  1 .  One  data  entry  per  line. 

MP  Card 
Field  Variable 

C  1-2  IC1 

C  3  IC3 

1  i 

2  PROP(l,i) 

3  PROP(2,i) 

4  PROP(3,i) 

5  PROP(4,i) 

Field  Variable  Value  Description 

C 1-2  IC1  MP  Card  group  identifier. 

C  3  IC3  2  Density  of  water  and  acceleration  of  gravity. 

1  ITUNIT  Index  of  time  unit. 


Material  property  parameters 
Value  Description 

MP  Card  group  identifier. 

1  Material  property. 

+  id  of  material  type. 

+  Manning’s  roughness  associated  with  the  material  type. 

+  xx-eddy  viscosity  associated  with  the  material  type  [L2/T]. 

+  yy-eddy  viscosity  associated  with  the  material  type  [L2/T]. 

+  xy-eddy  viscosity  associated  with  the  material  type  [L2/T]. 


1 

The  time  unit  for  simulation  is  second. 

2 

The  time  unit  for  simulation  is  minute. 

3 

The  time  unit  for  simulation  is  hour. 

2 

ILUNTT 

1 

Index  of  length  unit. 

The  length  unit  for  simulation  is  meter. 

2 

The  length  unit  for  simulation  is  foot. 

3 

The  length  unit  for  simulation  is  kilometer. 

4 

The  length  unit  for  simulation  is  mile. 

3 

RHO 

+ 

Density  of  water  [M/L3]. 

RF  Card 

Rainfall  parameters 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

RF 

Card  group  identifier. 

C  3 

IC3 

1 

Rainfall  data  for  the  simulation. 

1 

i 

+ 

id  of  global  element. 

2 

IRTYP(i) 

+ 

id  of  xy  series  to  describe  the  time-dependent  rainfall  rate 
for  the  element. 

SS  Card 

Source/sink  parameters 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

SS 

Card  group  identifier. 

C  3 

IC3 

1 

Source/sink  data  for  the  simulation. 

1 

i 

+ 

id  of  global  node. 

2 

ISR(i) 

+ 

id  of  xy  series  to  describe  the  time-dependent  source/sink  rate  for  the  node. 

OB  Card 

Open  boundary  parameters 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

OB 

Card  group  identifier. 

C  3 

IC3 

1 

Dirichlet  boundary  nodes  for  the  simulation. 

1 

NPDB(j) 

+ 

id  of  global  node  corresponding  to  the  j*  Dirichlet  boundary  node. 

2 

IDTYP(j) 

+ 

id  of  xy  series  to  describe  the  time-dependent  water  stage  or  water  depth 
profile  associated  with  the  Dirichlet  boundary  node. 

3 

IDHB(j) 

0 

Index  of  the  profile  type  for  the  j*11  Dirichlet  boundary  node. 

This  profile  is  a  time-dependent  water  depth  profile. 

1 

This  profile  is  a  time-dependent  water  stage  profile. 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

OB 

Card  group  identifier. 

C  3 

IC3 

2 

Flux-type  boundary  sides  for  the  simulation. 

1 

NSCB(j,l) 

+ 

id  of  global  node  corresponding  to  the  1st  node  of  the  j*  flux-type  boundary 

side. 

2 

NSCB(j,2) 

+ 

id  of  global  node  corresponding  to  the  2nd  node  of  the  j*  flux-type  boundary 

side. 

3 

NSCB(j,3) 

id  of  the  type  for  the  j*  flux-type  boundary  side. 

1  This  is  a  upstream  boundary  side  with  the  time-dependent  incoming  normal 
flux  specified. 

2  This  is  a  downstream  boundary  side  with  the  water  depth-dependent 
outgoing  normal  flux  specified. 
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3  This  is  either  a  river/stream-related  or  a  river/stream  junction-related 

boundary  side  with  the  water  depth-dependent  outgoing  normal  flux  (when 
overland  water  and  river/stream  water  are  separated)  or  stage  difference- 
dependent  normal  flux  (when  overland  water  and  river/stream  water  are 
connected)  specified. 


4 

ICTYP(j,l) 

+ 

id  of  xy  series  to  describe  the  time-dependent  normal  flux  profile  associated 
with  die  open  boundary  side  when  NSCB(j,3)  =  L 

5 

ICTYP(j,2) 

+ 

id  of  xy  series  to  describe  the  water  depth-dependent  normal  flux  profile 
associated  with  the  open  boundary  side  when  NSCB(j,3)  —  2,  or  3  (for  the 
case  that  river/stream  and  overland  waters  are  separated). 

6 

ICTYP(j,3) 

+ 

id  of  xy  series  to  describe  the  water  stage  difference-dependent  normal  flux 

profile  associated  with  the  open  boundary  side  when  NSCB(j,3)  =  3  (for 
the  case  that  river/stream  and  overland  waters  are  connected). 

ICCard 

Initial  condition  data  parameters 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

IC 

Card  group  identifier. 

C  3 

IC3 

H 

Water  depth  or  water  stage. 

1 

MEAD 

0 

Constant  water  depth  or  water  stage. 

1 

Variable  water  depth  or  water  stage. 

2 

©HEAD 

0 

Initial  water  depth  is  input. 

1 

Initial  water  stage  is  input. 

3 

HCONST 

+ 

Value  of  the  constant  water  depth  or  water  stage  for  IHEAD  =  0  [L]. 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

IC 

Card  group  identifier. 

C  3 

IC3 

U 

Velocity. 

1 

IV 

0 

Constant  velocity. 

1 

Variable  velocity. 

2 

UCONST 

+ 

Value  of  the  constant  velocity  [L/T]. 

3 

VCONST 

+ 

Value  of  the  constant  velocity  [L/T]. 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

IC 

Card  group  identifier. 

C  3 

IC3 

S 

Initial  condition  start  type. 

1 

ISTART 

0 

Cold  start,  water  depth/water  stage  and  velocity. 

1 

Hot  start,  water  stage  and  velocity. 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

IC 

Card  group  identifier. 

C  3 

IC3 

T 

Initial  condition  start  time. 

1 

HSTIME 

+ 

Time  corresponding  for  the  hot  start. 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

IC 

Card  group  identifier. 

C  3 

IC3 

F 

Initial  condition  start  type. 

1 

ICFILE 

0 

Text  format. 

1 

Binary  format. 
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XY  Card  X-Y  Series  Parameters 

Field  Variable  Value  Description 

C 1-2  IC1  XY  Card  group  identifier. 

C  3  IC3  1  Generation  of  any  x-y  series  function. 

1  i  +  Index  number  for  x-y  series. 

2  NPOINT(i)  +  The  number  of  x-y  values  in  the  series. 

3  DELTAX  0  Dummy  values. 

4  DELTAY  0  Dummy  values. 

5  REPEAT  0  Dummy  values. 

6  BEGCYC  0  Dummy  values. 

7  TNAME  +  A  character  string  representing  the  name  of  the  XY  series. 

(new  line)X,Y  After  XY  card,  the  x-y  values  of  the  series  are  listed  one  pair  per  line  up 

to  NPOINT(i). 

EN  Card  End  of  data  control 

Field  Variable  Value  Description 

Cl -2  IC1  EN  Card  group  identifier. 

C  3  IC3  D  End  of  input  data. 


1.6.  File  6: 1-D  river/stream  flow  file  (.lbc  file) 

Value  Description 

WMS 1BC  File  type  identifier 

T1-T3  Cards  Job  title 

Only  one  Tl,  T2,  and  T3  card  can  be  used. 

Run  option  parameters 
Value  Description 

OP  Card  group  identifier. 

1  Simulation  selection. 

Index  of  river/stream  simulation. 

0  No  river/stream  simulation. 

1  Only  flow  is  simulated. 

2  Both  flow  and  transport  are  simulated. 

Value  Description 

OP  Card  group  identifier. 

2  Solver  specification. 

Index  of  using  mass  lumping. 

0  No  mass  lumping. 

1  Mass  lumping. 

Index  of  using  linear  matrix  solver  for  flow  simulations. 

1  The  pointwise  iterative  matrix  solver. 

2  Preconditioned  Conjugate  Gradient  Method  (polynomial), 

3  Preconditioned  Conjugate  Gradient  Method  (Incomplete  Cholesky). 


OP  Card 
Field  Variable 
C  1-2  IC1 
C  3  IC3 
1  KMOD 


Field  Variable 
C  1-2  IC1 
C  3  IC3 
1  ILUMP 


2  IPNTS 
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3 

IQUAR 

Index  of  using  quadrature  for  numerical  integration. 

1 

Nodal  quadrature  for  line  element  integration. 

2 

Gaussian  quadrature  for  line  element  integration. 

4 

IDIFF 

Index  of  taking  into  account  the  eddy  viscosity  terms. 

1 

Yes. 

0 

No,  the  eddy  viscosity  terms  are  neglected. 

5 

IALLOW 

Index  of  allowing  the  simulation  to  continue  when  there  is  no 

convergence  reached  for  the  non-linear  iteration. 

1 

Yes. 

0 

No. 

6 

MODEL 

Index  of  simulating  overland  flow. 

3 

Using  MOC  to  solve  the  dynamic  model  only. 

2 

Using  the  diffusion  model  only. 

1 

Using  the  kinematic  model  only. 

-10 

Specifying  water  depth  and  velocity  as  the  initial  conditions.  The  flow 

equation  is  not  solved. 

Field 

Variable 

Value 

DescriDtion 

C  1-2 

IC1 

OP 

Card  group  identifier. 

C  3 

IC3 

3 

Weighting  factor  for  simulations. 

1 

W 

Time  derivative  weighting  factor  for  flow  simulation. 

0.5 

Crank-Nicolson  central. 

1.0 

Backward  difference. 

2 

OME 

Relaxation  parameter  for  solving  nonlinear  matrix  equations. 

0.0- 1.0  Under  relaxation. 

1.0 

Exact  relaxation. 

1. 0-2.0  Over  relaxation. 

3 

OMI 

Relaxation  parameter  for  solving  linearized  matrix  equation. 

0.0-1. 0  Under  relaxation. 

1.0 

Exact  relaxation. 

1. 0-2.0  Over  relaxation. 

Field 

Variable 

Value 

DescriDtion 

C  1-2 

IC1 

OP 

Card  group  identifier. 

C  3 

IC3 

4 

Preconditioned  Conjugate  Gradient  method. 

1 

IEIGEN 

0 

GGT  will  not  be  read. 

1 

GGT  will  be  read. 

2 

GG 

+ 

Upper  bound  of  the  maximum  eigenvalue  of  the  coefficient  matrix  used  in 

the  Preconditioned  Conjugate  Gradient  method. 

IP  Card 

Iteration  Parameters 

Field 

Variable 

Value 

DescriDtion 

C  1-2 

IC1 

IP 

Card  group  identifier. 

C  3 

IC3 

1 

Total  simulation  time. 

1 

NNITER 

+ 

Allowed  number  for  the  non-linear  iteration  in  the  flow  simulation. 

2 

NPITER 

+ 

Allowed  number  for  the  linearized  iteration  in  the  flow  simulation. 

3 

TOLBH 

+ 

Allowed  relative  error  for  water  depth. 

4 

TOLBV 

+ 

Allowed  relative  error  for  velocity  components. 

AppI-20 


5 


V_CUT 


FMSR 


Cut-off  of  velocity  [L/T]-  If  the  computed  velocity  is  smaller  than  this 
value,  it  is  set  to  zero. 

Multiplication  factor  to  set  the  allowed  mean  square  root  errors,  BHMSR 
for  water  depth  and  BVMSR  for  velocity,  where  BHMSR  = 
TOLBH*FMSR;  BVMSR  =  TOLBV*FMSR. 


PT  Card 


Particle  tracking  parameters 


Field 

Variable 

Value 

Description 

C  1-2 

IC1 

PT 

Card  group  identifier. 

C  3 

IC3 

1 

Particle  tracking  controlling  parameters. 

1 

NXW 

+ 

Subelement  number  used  in  the  X-direction 
tracking. 

2 

IDETQ 

1 

Index  of  particle  tracking  approach. 

Using  the  average-velocity  approach. 

2 

Using  the  constant-velocity  approach. 

TC  Card 

Iteration  Parameters 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

TC 

Card  group  identifier. 

C  3 

IC3 

1 

Total  simulation  time. 

1 

TMAX 

+ 

Maximum  simulation  time  [T]. 

2 

DELT 

+ 

Initial  time  step  size  [Tj. 

Field  Variable 
C  1-2  IC1 
C  3  IC3 
1  IDTXY 


OC  Card 
Field  Variable 
C  1-2  IC1 
C  3  IC3 

1  IBUG 

2  JOPT 

3  KPRT 
NPRINT 


Value  Description 
TC  Card  group  identifier. 

2  Computational  time  step. 

+  Index  of  xy  series  for  variable  time  step. 

Output  control  parameters 
Value  Description 
OC  Card  group  identifier. 

1  Print  control  parameters. 

0  Do  not  print  the  diagnostic  output. 

1  Do  print  the  diagnostic  output. 

0  Print  at  specified  interval. 

1  Print  at  specified  set  of  time  values. 

+  Specify  the  interval  if  JOPT  =  0. 

+  Specify  total  number  of  the  specified  times,  if  JOPT=l . 


Note:  NPRINT  new  lines  after  OC1  card  are  needed  if  JOPT  =  1 
(the  first  new  line) 

1  TPRT(l)  +  The  1st  specified  time  moment  at  wl 


(the  second  new  line) 
1  TPRT(2) 


The  1st  specified  time  moment  at  which  the  associated  simulation  results  are 
to  be  printed. 

The  2nd  specified  time  moment  at  which  the  associated  simulation  results 
are  to  be  printed. 


(the  NPRINT  new  line) 
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TPRT(NPRINT)  +  The  NPRINT^  specified  time  moment  at  which  the  associated  simulation 

results  are  to  be  printed. 


Field 

Variable 

Value 

Description 

C  1-2 

IC1 

OC 

Card  group  identifier 

C  3 

IC3 

2 

Print  options. 

1 

NSELT 

+ 

Total  options  to  be  selected. 

2 

KPRO(i) 

1 

Print  options. 

Print  water  depth. 

2 

Print  velocity/discharge. 

3 

Print  concentration. 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

OC 

Card  group  identifier. 

C  3 

IC3 

3 

Output  control  for  post-process. 

1 

MLE 

0 

Save  as  ascii  format. 

1 

Save  as  binary  format. 

2 

KOPT 

0 

Save  at  specified  interval. 

1 

Save  at  specified  set  of  times. 

3 

KDSK 

+ 

Save  every  specified  interval,  if  KOPT=0. 

NPOST 

+ 

Save  at  specified  set  of  times,  if  KOPT=l. 

Note: 

NPOST  new  lines  after  OC3  card  are  needed  if  KOPT  =  1 . 

(the  first  new  line) 

1  TSV(l) 

+ 

The  1st  specified  time  moment  at  which  the  associated  simulation  results  are 

to  be  saved. 

(the  second  new  line) 

The  2nd  specified  time  moment  at  which  the  associated  simulation  results 

1 

TSV(2) 

+ 

are  to  be  saved. 

(the  NPOST  new  line) 

The  NPOST"1  specified  time  moment  at  which  the  associated  simulation 

1 

TSV(NPOST) 

+ 

results  are  to  be  saved. 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

OC 

Card  group  identifier. 

C  3 

IC3 

4 

Solution  file  output  options. 

1 

KSELT 

+ 

Total  options  to  be  selected. 

2 

KSAVE(i) 

1 

Save  options. 

Save  water  depth. 

2 

Save  flux. 

3 

Save  infiltration  rate. 

GC  Card 

Cross  section  Darameters 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

GC 

Card  group  identifier. 

C  3 

IC3 

1 

Generate  cross  section  to  calculate  discharge. 

1 

NGCL 

+ 

Total  number  of  cross  sections. 
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Field  Variable 

Value 

Description 

C  1-2  IC1 

GC 

Card  group  identifier. 

C  3  IC3 

2 

Cross  section  information. 

1  id 

+ 

Index  number  of  cross  section. 

2  NPL 

+ 

Number  of  nodal  points  in  the  x-section. 

(new  line) 

+ 

Node  points. 

Field  Variable 

Value 

Description 

C  1-2  IC1 

GC 

Card  group  identifier. 

C  3  IC3 

3 

Save  and  print  hydrograph. 

1  LOPT 

0 

Save  and  print  at  specified  interval. 

1 

Save  and  print  at  specified  set  of  times. 

2  LDSK 

0 

Save  and  print  at  specified  interval. 

+ 

Save  and  print  every  specified  interval,  if  LOPT=0. 

3  LPOST 

+ 

Save  and  print  at  specified  set  of  times,  if  LOPT=l. 

Note:  LPOST  new  lines  after  GC3  card  are  needed  if  LOPT  =  1 . 

(the  first  new  line) 

1  TSA(l) 

+ 

The  1st  specified  time  moment  at  which  the  associated  hydrographs  are  to 

(the  second  new  line) 

be  saved. 

1  TSA(2) 

+ 

The  2nd  specified  time  moment  at  which  the  associated  hydrographs  are  to 

(the  NPOST  new  line) 

be  saved. 

1  TSA(LPOST)  + 

The  LPOSTth  specified  time  moment  at  which  the  associated  hydrographs 

(new  line) 

+ 

are  to  be  saved. 

After  GC3  card,  specify  the  times,  if  LOPT  =  1.  One  data  entry  per  line. 

MP  Card 

Material  proDertv  narameters 

Field  Variable 

Value 

Description 

C  1-2  IC1 

MP 

Card  group  identifier. 

C  3  IC3 

1 

Material  property. 

1  i 

+ 

id  of  material  type. 

2  PROP(l,i) 

+ 

Manning’s  roughness  associated  with  the  material  type. 

3  PROP(2,i) 

+ 

x-eddy  viscosity  associated  with  the  material  type  [L2/T]. 

Field  Variable 

Value 

Descriotion 

C  1-2  IC1 

MP 

Card  group  identifier. 

C  3  IC3 

2 

Density  of  water  and  acceleration  of  gravity. 

1  ITUNIT 

Index  of  time  unit. 

1 

The  time  unit  for  simulation  is  second. 

2 

The  time  unit  for  simulation  is  minute. 

3 

The  time  unit  for  simulation  is  hour. 

2  ILUNIT 

Index  of  length  unit. 

1 

The  length  unit  for  simulation  is  meter. 

2 

The  length  unit  for  simulation  is  foot. 

3 

The  length  unit  for  simulation  is  kilometer. 

AppI-23 


4 

The  length  unit  for  simulation  is  mile. 

3 

RHO 

+ 

Density  of  water  [M/L3]. 

RF  Card 

Rainfall  parameters 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

RF 

Card  group  identifier. 

C  3 

IC3 

1 

Rainfall  data  for  the  simulation. 

1 

i 

+ 

id  of  global  element. 

2 

IRTYP(i) 

+ 

id  of  xy  series  to  describe  the  time-dependent  rainfall  rate  for  the  element. 

SS  Card 

Source/sink  parameters 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

SS 

Card  group  identifier. 

C  3 

IC3 

1 

Source/sink  data  for  the  simulation. 

1 

i 

+ 

id  of  global  node. 

2 

ISR(i) 

+ 

id  of  xy  series  to  describe  the  time-dependent  source/sink  rate  for  the  node. 

OB  Card 

Open  boundary  parameters 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

OB 

Card  group  identifier. 

C3 

IC3 

1 

Open  boundary  for  the  simulation. 

1 

NPDB(j,l) 

+ 

id  of  global  node  corresponding  to  the  j*  open  boundary  node. 

2 

NPDB(j.2) 

1 

id  of  the  type  for  the  open  boundary  node. 

This  is  a  boundary  node  with  the  time-dependent  water  stage  specified. 

2 

This  is  a  upstream  boundary  node  with  the  time-dependent  incoming  norma 
lflux  specified. 

3 

This  is  a  downstream  boundary  node  with  the  water  depth-dependent 
outgoing  normal  flux  specified. 

3 

IDTYP(j,l) 

+ 

id  of  xy  series  to  describe  the  time-dependent  water  stage  or  water  depth 
profile  associated  with  the  open  boundary  node  when  NPDB(j,2)  =  1. 

4 

IDTYP(j,2) 

+ 

id  of  xy  series  to  describe  the  time-dependent  normal  flux  profile  associated 
with  the  open  boundary  node  when  NPDB(j,2)  =  2. 

5 

IDTYP(j,3) 

+ 

id  of  xy  series  to  describe  the  water  depth-dependent  normal  flux  profile 
associated  with  the  open  boundary  node  when  NPDB(j,2)  =  3. 

6 

IDHBO) 

0 

Index  of  the  profile  type  for  IDTYP(j,2)  when  NPDB(j,2)  =  2. 

This  profile  is  a  time-dependent  water  depth  profile. 

1 

This  profile  is  a  time-dependent  water  stage  profile. 

CS  Card 

River/stream  cross-sectional  parameters 

Field 

Variable 

Value 

Descrintion 

C  1-2 

IC1 

CS 

Card  group  identifier. 

C  3 

IC3 

1 

Profile  types  for  river/stream  cross-sectional  geometry. 

1 

j 

ICHN(j,l) 

+ 

id  of  river/stream  node. 

2 

+ 

id  of  xy  series  to  describe  the  water  depth-dependent  cross-sectional  area 
profile  for  the  river/stream  node. 

3 

ICHN(j,2) 

+ 

id  of  xy  series  to  describe  the  water  depth-dependent  wetted  perimeter 
profile  for  the  river/stream  node. 

4 

ICHN(j,3) 

+ 

id  of  xy  series  to  describe  the  water  depth-dependent  top  river/stream  width 
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profile  for  the  river/stream  node. 


Note: 

The  top  river/stream  width  value  at  zero  water  depth  must  be  GREATER  than  zero  when  describing 
the  profile  associated  with  it. 

Field 

Variable 

Value  DescriDtion 

C  1-2 

IC1 

CS  Card  group  identifier. 

C  3 

IC3 

2  Entire  river/stream  width  . 

1 

j 

+  id  of  river/stream  node. 

2 

CHNW(j) 

+  The  entire  river/stream  width  through  which  rainfall  can  contribute  to 

river/stream  at  the  river/stream  node.  [L] 

RH  Card 

River/stream  reach  parameters 

Field 

Variable 

Value  Description 

C  1-2 

IC1 

RH  Card  group  identifier. 

C  3 

IC3 

1  River/stream  nodes  included  in  each  river/stream  reach. 

1 

j 

+  id  of  river/stream  reach. 

2 

nn 

+  Number  of  nodes  included  in  the  river/stream  reach. 

Note:  A  river/stream  reach  must  include  at  least  four  river/stream  nodes. 

Note:  One  new  line  after  RH1  card  is  needed. 

(new  line,  including  nn  data) 

NPINRH(  1  ..nn,j)  +Node  numbers  of  river/stream  nodes  that  are  included  in  the  river/stream 

reach.  These  nodes  must  be  given  in  order  from  the  upstream  to  the 
downstream. 


JT  Card 

River/stream  iunctions 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

JT 

Card  group  identifier. 

C  3 

IC3 

1 

parameters  of  junction  geometry. 

1 

j 

+ 

id  of  river/stream  junction. 

Note: 

A  river/stream  dead  end  is  treated  as  a  river/stream  junction. 

2 

NPJT(j) 

+ 

id  of  overland  global  node  that  is  associated  with  the  j*  junction. 

3 

rvjT(j) 

+ 

id  of  xy  series  to  describe  the  volume-water  depth  relationat  the 
river/stream  junction. 

4 

IDJCNTG) 

1 

This  junction  is  to  simulate  a  big  lake  and  the  water  stage  at  junction’s 
outlets  are  considered  to  be  the  same  as  the  junction’s. 

0 

Otherwise. 

5 

AJT(j) 

+ 

Horizontal  area  of  the  junction,  through  which  both  rainfall  and  infiltration 
can  contribute  to  the  change  of  water  depth  of  the  junction  [L2]. 

6 

Z0JT(j) 

+ 

Bottom  elevation  of  the  junction  [L]. 

Field 

Variable 

Value 

DescriDtion 

C  1-2 

IC1 

JT 

Card  group  identifier. 

C  3 

IC3 

2 

river/stream  reaches  and  nodes  associated  with  river/stream  junctions. 

1 

j 

+ 

id  of  river/stream  junction. 
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Note:  A  river/stream  dead  end  is  treated  as  a  river/stream  junction. 

2  NJTRH(j)  +  Number  of  river/stream  reaches  that  connect  to  one  another  through  the 

river/stream  junction. 

Note:  If  this  river/stream  junction  is  simulating  a  pond  without  outlet,  NJTRH0)  =  O. 

(newline)  IDJT(l,l..nn,j)  id  of  river/stream  global  nodes  which  coincide  with  the  junction  and  are  the 

end  nodes  of  the  reaches  connected  to  the  junction,  (nn  =  NJTRH(j)) 

(new  line)  n>JT(2,l..nn,j)  id  of  river/stream  global  nodes  which  are  the  nodes  next  to  the  nodes 

specified  in  IDJT(l,l..nn,j).  (nn  =  NJTRH(j)) 

Note:  IDJT(l,i,j)  must  match  IDJT(2,i,j)  for  the  i*  reach  connected  to  the  j*  junction. 


Field  Variable 
C  1-2  IC1 
C  3  IC3 

1  j 


Value  Description 
JT  Card  group  identifier. 

3  junction-related  overland  boundary  sides. 

+  id  of  river/stream  junction. 


Note:  A  river/stream  dead  end  is  treated  as  a  river/stream  junction. 

2  NJT12(j)  +  Number  of  junction-related  overland  boundary  segments. 

Note:  nn  new  lines  after  JT3  card  are  needed,  where  nn  —  NJT12(j). 

(the  first  new  line) 

1  NSJT12(1,1)  +  The  2-D  global  node  that  corresponds  to  the  1  node  ot  the 

overland  boundary  segment  of  the  river/stream  junction. 

2  NSJT12(2,1)  +  The  2-D  global  node  that  corresponds  to  the  2nd  node  of  the 

overland  boundary  segment  of  the  river/stream  junction. 


1st  surrounding 
1st  surrounding 


(the  nn111  new  line) 

1  NSJT12(l,nn)  + 

2  NSJT12(2,nn)  + 


The  2-D  global  node  that  corresponds  to  the  Is'  node  of  the  nn*  surrounding 
overland  boundary  segment  of  the  river/stream  junction. 

The  2-D  global  node  that  corresponds  to  the  2nd  node  of  the  nn*  surrounding 
overland  boundary  segment  of  the  river/stream  junction. 


IC  Card 

Initial  condition  data  parameters 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

IC 

Card  group  identifier. 

C  3 

IC3 

H 

Water  depth  or  water  stage. 

1 

MEAD 

0 

Constant  water  depth  or  water  stage. 

1 

Variable  water  depth  or  water  stage. 

2 

©HEAD 

0 

Initial  water  depth  is  input. 

1 

Initial  water  stage  is  input. 

3 

HCONST 

+ 

Value  of  the  constant  water  depth  or  water  stage  for  IHEAD  =  0  [L] 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

IC 

Card  group  identifier. 

C  3 

IC3 

U 

Velocity. 

1 

IV 

0 

Constant  velocity. 

1 

Variable  velocity. 

2 

UCONST 

± 

Value  of  the  constant  velocity  [L/T|. 
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Field 

Variable 

Value 

Description 

Cl-2 

IC1 

IC 

Card  group  identifier. 

C  3 

IC3 

S 

Initial  condition  start  type. 

1 

ISTART 

0 

Cold  start,  water  depth/water  stage  and  velocity. 

1 

Hot  start,  water  depth/water  stage  and  velocity. 

Field 

Variable 

Value 

Description 

Cl-2 

IC1 

IC 

Card  group  identifier. 

C  3 

IC3 

T 

Initial  condition  start  time. 

1 

HSTIME 

+ 

Time  corresponding  for  the  hot  start  [T], 

Field 

Variable 

Value 

Description 

Cl-2 

IC1 

IC 

Card  group  identifier. 

C  3 

IC3 

F 

Initial  condition  start  type. 

1 

ICFILE 

0 

Text  format. 

1 

Binary  format. 

XYCard 

X-Y  Series  Parameters 

Field 

Variable 

Value 

Description 

Cl-2 

IC1 

XY 

Card  group  identifier. 

C  3 

IC3 

1 

Generation  of  any  x-y  series  function. 

1 

i 

+ 

Index  number  for  x-y  series. 

2 

NPOINT(i) 

+ 

The  number  of  x-y  values  in  the  series. 

3 

DELTAX 

0 

Dummy  values. 

4 

DELTAY 

0 

Dummy  values. 

5 

REPEAT 

0 

Dummy  values. 

6 

BEGCYC 

0 

Dummy  values. 

7 

TNAME 

+ 

A  character  string  representing  the  name  of  the  XY 

(new  line)X,Y  After  XY  card,  the  x-y  values  of  the  series  are  listed  one  pair 

per  line  up  to  NPOINT(i). 


ENCard 
Field  Variable 
Cl-2  IC1 
C  3  IC3 


End  of  data  control 
Value  Description 
EN  Card  group  identifier. 

D  End  of  input  data. 


1.7.  File  7:  3-D  subsurface  transport  file  (3tp  file) 


Value  Description 

WMS3TP  File  type  identifier 


T1-T3  Cards  Job  title 

Only  one  Tl,  T2,  and  T3  card  can  be  used. 


OP  Card 
Field  Variable 
Cl-2  IC1 


Run  option  parameters 
Value  Description 
OP  Card  group  identifier 
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C  3 

IC3 

2 

Solver  options. 

1 

ILUMPT 

0 

No  mass  lumping. 

1 

Mass  lumping, 

2 

IPNTST 

Matrix  solver  for  flow  and  transport  simulations. 

1 

The  pointwise  iterative  matrix  solver 

2 

Preconditioned  Conjugate  Gradient  Method  (polynomial). 

3 

Preconditioned  Conjugate  Gradient  Method  (Incomplete  Cholesky). 

3 

IQUART 

Index  of  using  quadrature  for  numerical  integration. 

11 

Nodal  quadrature  for  the  integration  of  an  element  face  and  an  element. 

12 

Nodal  quadrature  for  the  integration  of  an  element  face,  Gaussian  quadrature 

for  the  integration  of  an  element. 

21 

Gaussian  quadrature  for  the  integration  of  an  element  face.  Nodal  quadrature 

for  the  integration  of  an  element. 

22 

Gaussian  quadrature  for  the  integration  of  an  element  face  and  an  element. 

4 

LAD  APT 

Index  of  using  adapted  implicit-explicit  scheme  for  the  predictor  step. 

0 

No. 

1 

Yes. 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

OP 

Card  group  identifier 

C  3 

IC3 

3 

Weighting  factor  for  flow  and  transport  simulations; 

1 

WT 

Time  derivative  weighting  factor  for  flow  and  transport  simulation. 

0.5 

Crank-Nicolson  central 

1.0 

Backward  difference 

2 

OMET 

Iteration  parameter  for  solving  nonlinear  matrix  equations. 

0.0- 1.0  Under  relaxation. 

1.0 

Exact  relaxation. 

1. 0-2.0  Over  relaxation. 

3 

OMIT 

Iteration  parameter  for  solving  linearized  matrix  equation  pointwise. 

0.0- 1.0  Under  relaxation. 

1.0 

Exact  relaxation. 

1. 0-2.0  Over  relaxation. 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

OP 

Card  group  identifier 

C  3 

IC3 

5 

Parameters  for  Preconditioned  Conjugate  Gradient  method; 

1 

IEIGENT 

0 

GGT  will  not  be  read. 

1 

GGT  will  be  read. 

2 

GGT 

+ 

Upper  bound  of  the  maximum  eigenvalue  of  the  coefficient 

matrix  used  in  the  Preconditioned  Conjugate  Gradient  method. 

IP  Card 

Iteration  Parameters 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

IP 

Card  group  identifier 

C  3 

IC3 

2 

Iteration  parameters  for  solving  transport  equations 

1 

NTTERT 

+ 

Number  of  iterations  allowed  for  solving  the  non-linear  transport  equation. 

2 

NPITERT 

+ 

Number  of  iterations  permitted  for  solving  the  linearized  transport  equations. 

i.e.,  this  value  is  used  in  matrix  solver. 
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3  TOLBT  +  The  convergent  criteria  (allowed  relative  error)  for  the  implementation  of 

iteration  scheme  in  the  transient-state  transport  simulation. 


PT  Card 

Particle  Tracking  Parameters 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

PT 

Card  group  identifier 

C  3 

IC3 

1 

Particle  tracking  parameters 

1 

NXW 

+ 

The  number  of  grids  for  sub-element  tracking  in  the  x-direction. 

2 

IDETQ 

1 

Index  of  particle  tracking  velocity. 

Average  velocity  of  starting  and  ending  points  is  used. 

2 

Single  velocity  of  starting  point  is  used. 

MP  Card 

Material  Drooertv  parameters 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

MP 

Card  group  identifier 

C  3 

IC3 

5 

Dispersion/diffusion  coefficients. 

1 

I 

+ 

Material  type  ID. 

2 

PROPT(l,I) 

+ 

Bulk  density,  rb  for  medium  I  [M/L3]. 

3 

PROPT(2,I) 

+ 

Longitudinal  dispersion,  aL  for  medium  I  [L], 

4 

PROPT(3,I) 

+ 

Transverse  dispersion,  aT  for  medium  I  [L]. 

5 

PROPT(4,I) 

+ 

Molecular  diffusion  coefficient,  aw  for  medium  I  [L2/T|. 

6 

PROPT(5,I) 

+ 

Tortuosity,  x  for  medium  I  [dimensionless]. 

7 

PROPT(6,I) 

+ 

The  effective  porosity  of  the  medium  L  ne  [L3/L3]. 

PS  Card 

Point  source/sink  parameters 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

PS 

Card  group  identifier 

C  3 

IC3 

2 

Point  source/sink  concentration  for  transport  simulation. 

1 

ID 

+ 

id  of  point  source/sink. 

2 

NPWT(ID) 

+ 

Node  number  of  the  Ith  point  source/sink. 

3 

NCHEM 

+ 

Number  of  dissolved  chemicals. 

(NCHEM  more  lines  are  needed.  Each  line  contains  the  following  information. 

1 

i 

+ 

id  of  dissolved  chemical. 

2 

IWTYPT(ID,i)  + 

Index  of  the  source  rate  xy  series. 

DB  Card 

Dirichlet  boundary  parameters 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

DB 

Card  group  identifier. 

C  3 

IC3 

2 

Dirichlet  boundary  conditions,  prescribed  concentration  for  transport 
simulation. 

1 

NP 

+ 

id  of  Dirichlet  boundary  node. 

2 

NPDBT(NP) 

+ 

id  of  global  node  corresponding  to  the  Dirichlet  boundary  node. 

3 

NCHEM 

+ 

Number  of  dissolved  chemicals. 

(NCHEM  more  lines  are  needed.  Each  line  contains  the  following  information. 

1  i  +  id  of  dissolved  chemical. 

2  DDTYPT(NP,i)  +  id  of  xy  series  to  described  the  time-dependent  concentration  profile 
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associated  with  the  Dirichlet  boundary  node  for  the  dissolved  chemical. 

CB  Card 
Field  Variable 
C  1-2  IC1 
C  3  IC3 

1  NS 

2  M 

3  IDCT(NS) 

4  NCHEM 

(NCHEM  more  lines  are  needed.  Each  line  contains  the  following  information. 

1  i  +  id  of  dissolved  chemical. 

2  ICTYPT(NS,i)  +  id  of  xy  series  to  described  the  time-dependent  concentration  flux  profile 

associated  with  the  Cauchy  boundary  side  for  the  dissolved  chemical. 

NB  Card 
Field  Variable 

C  1-2  IC1 

C  3  IC3 

1  NS 

2  M 

3  IDNT(NS) 

4  NCHEM 

(NCHEM  more  lines  are  needed.  Each  line  contains  the  following  information. 

1  i  +  id  of  dissolved  chemical. 

2  INTYPT(NS,i)  +  id  of  xy  series  to  described  the  time-dependent  concentration  flux  profile 

associated  with  the  Neumann  boundary  side  for  the  dissolved  chemical. 

RS  Card  Variable  boundary  parameters 

Field  Variable  Value  Description 

C 1-2  IC1  RS  Card  group  identifier 

C  3  IC3  2  Variable  boundary  conditions,  prescribed  concentration  for  transport 

simulation. 

1  NS  +  id  of  Variable  boundary  side. 

2  M  +  id  of  global  element  corresponding  to  the  Variable  boundary  side. 

3  IDNT(NS)  +  idofelementfacecorrespondingtotheVariableboundaryside(rangingfrom 

1  to  6). 

4  NCHEM  +  Number  of  dissolved  chemicals. 

(NCHEM  more  lines  are  needed.  Each  line  contains  the  following  information. 

1  i  +  id  of  dissolved  chemical. 

2  INTYPT(NS,i)  +  id  of  xy  series  to  described  the  time-dependent  concentration  flux  associated 


Neumann  boundary  parameters 
Value  Description 

NB  Card  group  identifier 

2  Neumann  boundary  conditions,  prescribed  dispersive  mass  flux  rate  for 
transport  simulation. 

+  id  of  Neumann  boundary  side. 

+  id  of  global  element  corresponding  to  the  Neumann  boundary  side. 

+  id  of  element  face  corresponding  to  the  Neumann  boundary  side  (ranging 
from  1  to  6). 

+  Number  of  dissolved  chemicals. 


Cauchv  boundary  parameters 
Value  Description 
CB  Card  group  identifier 

2  Cauchy  boundary  conditions,  prescribed  mass  flux  rate  for  transport 
simulation. 

+  id  of  Cauchy  boundary  side. 

+  id  of  global  element  corresponding  to  the  Cauchy  boundary  side. 

+  id  of  element  face  corresponding  to  the  Cauchy  boundary  side  (ranging  from 
1  to  6). 

+  Number  of  dissolved  chemicals. 
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with  the  Variable  boundary  side  for  the  dissolved  chemical. 


IC  Card 

Initial  condition  data  narameters 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

IC 

Card  group  identifier 

C  3 

IC3 

1 

Constant  or  variable  initial  concentration. 

1 

IDCONC 

0 

Constant  initial  concentration. 

1 

Spatially  variable  initial  concentration. 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

IC 

Card  group  identifier. 

C  3 

IC3 

2 

Initially  constant  conditions  for  dissolved  chemicals. 

1 

j 

+ 

id  of  the  dissolved  chemical  being  input. 

2 

CCONST(j) 

+ 

Specified  initial  concentration  for  the  dissolved  chemical.  [M/L3]. 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

IC 

Card  group  identifier. 

C  3 

IC3 

3 

Initially  constant  conditions  for  adsorbing  sites. 

1 

j 

+ 

id  of  the  adsorbing  site  being  input. 

2 

srrcoN(j) 

+ 

Specified  initial  concentration  for  the  adsorbing  site.  [M/L3]. 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

IC 

Card  group  identifier. 

C  3 

IC3 

4 

Initially  constant  conditions  for  adsorbed  chemicals. 

1 

j 

+ 

id  of  the  adsorbed  chemical  being  input. 

2 

SORCON(j) 

+ 

Specified  initial  concentration  for  the  adsorbed  chemical.  [M/L3]. 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

IC 

Card  group  identifier 

C  3 

IC3 

F 

Initial  condition  file  format. 

1 

ICFILE 

0 

The  initial  condition  files  are  in  text  format. 

1 

The  initial  condition  files  are  in  binary  format. 

XYCard 

X-Y  Series  Parameters 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

XY 

Card  group  identifier 

C  3 

IC3 

1 

Generation  of  any  x-y  series  function. 

1 

i 

+ 

Index  number  for  x-y  series, 

2 

NPOINT(i) 

+ 

The  number  of  x-y  values  in  the  series. 

3 

DELTAX 

0 

Dummy  values. 

4 

DELTAY 

0 

Dummy  values. 

5 

REPEAT 

0 

Dummy  values. 

6 

BEGCYC 

0 

Dummy  values. 

7 

TNAME 

+ 

A  character  string  representing  the  name  of  the  XY  series. 

(new  line)X,Y 

±,± 

After  XY  card,  the  x-y  values  of  the  series  are  listed  one  pair  per  line  up 

NPOINT(i). 

ENCard 

End  of  data  control 
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Field 

Variable 

Value 

Description 

Cl-2 

IC1 

EN 

Card  group  identifier 

C  3 

IC3 

D 

End  of  input  data 

1.8.  File  8: 2-D  overland  transport  file  (-2tp  file) 


Value  Description 

WMS2TP  File  type  identifier 

T1-T3  Cards  Job  title 

Only  one  Tl,  T2,  and  T3  card  can  be  used. 


OP  Card  Run  option  parameters 


Field 

Variable 

Value 

Description 

C  1-2 

IC1 

OP 

Card  group  identifier. 

C  3 

IC3 

1 

Simulation  selection. 

1 

IDCHEM 

Index  of  chemical  transport  simulation. 

0 

Chemical  transport  is  not  simulated. 

1 

Chemical  transport  is  simulated. 

2 

IDSED 

Index  of  sediment  transport  simulation. 

0 

Sediment  transport  is  not  simulated. 

1 

Sediment  transport  is  simulated. 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

OP 

Card  group  identifier. 

C  3 

IC3 

2 

Solver  specification. 

1 

ILUMPT 

Index  of  using  mass  lumping  for  transport  simulations. 

0 

No  mass  lumping. 

1 

Mass  lumping. 

2 

IPNTST 

Index  of  using  linear  matrix  solver  for  transport  simulations. 

1 

The  pointwise  iterative  matrix  solver. 

2 

Preconditioned  Conjugate  Gradient  Method  (polynomial). 

3 

Preconditioned  Conjugate  Gradient  Method  (Incomplete  Cholesky). 

3 

IQUART 

Index  of  using  quadrature  for  numerical  integration. 

1 

Nodal  quadrature  for  line  element  integration. 

2 

Gaussian  quadrature  for  line  element  integration. 

4 

IADAPT 

Index  of  using  adapted  implicit-explicit  scheme  for  the  predictor  step 

0 

No. 

1 

Yes. 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

OP 

Card  group  identifier. 

C  3 

IC3 

3 

Weighting  factor  for  transport  simulations. 

1 

WT 

Time  derivative  weighting  factor  for  transport  simulation. 

0.5 

Crank-Nicolson  central. 

1.0 

Backward  difference. 

2 

OMET 

Relaxation  parameter  for  solving  nonlinear  matrix  equations. 
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0.0- 1.0  Under  relaxation. 

1.0  Exact  relaxation. 

1. 0-2.0  Over  relaxation. 

3  OMIT  Relaxation  parameter  for  solving  linearized  matrix  equation. 

0.0-1.0  Under  relaxation. 

1.0  Exact  relaxation. 

1. 0-2.0  Over  relaxation. 


Held 

Variable 

Value 

Description 

C  1-2 

IC1 

OP 

Card  group  identifier. 

C  3 

IC3 

4 

Preconditioned  Conjugate  Gradient  method. 

1 

IEIGENT 

0 

GGT  will  not  be  read. 

1 

GGT  will  be  read. 

2 

GGT 

+ 

Upper  bound  of  the  maximum  eigenvalue  of  the  coefficient  matrix  used  in 
the  Preconditioned  Conjugate  Gradient  method. 

IP  Card 

Iteration  Parameters 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

IP 

Card  group  identifier. 

C  3 

IC3 

1 

Total  simulation  time. 

1 

NNITERT 

+ 

Allowed  number  for  the  non-linear  iteration. 

2 

NPITER 

+ 

Allowed  number  for  the  linearized  iteration. 

3 

TOLBC 

+ 

Allowed  relative  error  for  getting  convergent  transport  solutions  for  both 
dissolved  and  particulate  chemicals. 

4 

TOLBS 

+ 

Allowed  relative  error  for  getting  convergent  transport  solutions  for 
sediments. 

PT  Card 

Particle  trackine  parameters 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

PT 

Card  group  identifier. 

C  3 

IC3 

1 

Particle  tracking  controlling  parameters. 

1 

NXWT 

+ 

Subelement  number  in  one  direction  that  is  used  in  the  “in-element”  particle 
tracking.  The  total  subelement  number  included  in  one  global  element  is 
NXWT*NXWT. 

2 

IDETQT 

1 

Index  of  particle  tracking  approach. 

Using  the  average-velocity  approach. 

2 

Using  the  constant-velocity  approach. 

MP  Card 

Material  orooertv  parameters 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

MP 

Card  group  identifier. 

C  3 

IC3 

1 

Material  property  for  transport. 

1 

i 

+ 

id  of  material  type. 

2 

PROPT(l,i) 

+ 

Longitudinal  dispersivity  associated  with  the  material  type  [L], 

3 

PROPT(2,i) 

+ 

Lateral  dispersivity  associated  with  the  material  type  [L]. 

4 

PROPT(3,i) 

+ 

Pure  diffusion  coefficient  associated  with  the  material  type  [L2/T]. 

SS  card 

Source/sink  parameters 
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Field 

Variable 

Value 

Description 

C  1-2 

IC1 

SS 

Card  group  identifier. 

C  3 

IC3 

1 

Source/sink  profile  for  dissolved  chemicals. 

1 

NP 

+ 

id  of  global  node. 

2 

j 

+ 

id  of  dissolved  chemical. 

3 

ITSR(NP,j) 

+ 

id  of  xy  series  to  describe  the  time-dependent  source/sink  profile  for  the 
dissolved  chemical  at  the  global  node. 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

SS 

Card  group  identifier. 

C  3 

IC3 

2 

Source/sink  profile  for  suspended  sediment. 

1 

NP 

+ 

id  of  global  node. 

2 

j 

+ 

id  of  suspended  sediment  size. 

3 

NCHEM 

+ 

Number  of  dissolved  chemicals. 

4 

ITSR(m) 

+ 

id  of  xy  series  to  describe  the  time-dependent  source/sink  profile  for  the 
suspended  sediment  size  at  the  global  node,  where  m  =  NCHEM  +  j. 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

SS 

Card  group  identifier. 

C  3 

IC3 

3 

Source/sink  profile  for  particulate  chemicals  on  suspended  sediments. 

1 

NP 

+ 

id  of  global  node. 

2 

j 

+ 

id  of  suspended  sediment. 

3 

k 

+ 

id  of  particulate  chemical. 

4 

NCHEM 

+ 

Number  of  dissolved  chemicals. 

5 

NSSIZE 

+ 

Number  of  sediment  sizes. 

6 

ITSR(m) 

+ 

id  of  xy  series  to  describe  the  time-dependent  source/sink  profile  for  the 

particulate  chemical  on  the  suspended  sediment  size  at  the  global  node, 
where  m  =  NCHEM  +  NSSIZE  +  (j-l)*NCHEM  +  k,  j  e  [1, NSSIZE],  and 
k  e[l,  NCHEM]. 

DB  Card 

Dirichlet  boundary  oarameters 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

DB 

Card  group  identifier. 

C3 

IC3 

1 

Dirichlet  boundary  conditions  for  dissolved  chemicals. 

1 

NP 

+ 

id  of  Dirichlet  boundary  node. 

2 

NPDBT(NP) 

+ 

id  of  global  node  corresponding  to  the  Dirichlet  boundary  node. 

3 

i 

+ 

id  of  dissolved  Chemical. 

4 

IDTYPT(NP,i) 

+ 

id  of  xy  series  to  describe  the  time-dependent  concentration  profile  associated 
with  the  Dirichlet  boundary  node  for  the  dissolved  chemical. 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

DB 

Card  group  identifier. 

C3 

IC3 

2 

Dirichlet  boundary  conditions  for  suspended  sediments. 

1 

NP 

+ 

id  of  Dirichlet  boundary  node. 

2 

NPDBT(NP) 

+ 

id  of  global  node  corresponding  to  the  Dirichlet  boundary  node. 

3 

k 

+ 

id  of  suspended  sediment  size. 

4 

NCHEM 

+ 

Number  of  dissolved  chemicals. 

5 

IDTYPT(NP,i) 

+ 

id  of  xy  series  to  describe  the  time-dependent  concentration  profile 
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associated  with  the  Dirichlet  boundary  node  for  the  suspended  sediment, 
where  i  =  NCHEM+L 


Field  Variable 

Value 

Description 

C  1-2  IC1 

DB 

Card  group  identifier. 

C  3  IC3 

3 

Dirichlet  boundary  conditions  for  particulate  chemicals  on  suspended 
sediments. 

1  NP 

+ 

id  of  Dirichlet  boundary  node. 

2  NPDBT(NP) 

+ 

id  of  global  node  corresponding  to  the  Dirichlet  boundary  node. 

3  j 

+ 

id  of  suspended  sediment  size. 

4  k 

+ 

id  of  particulate  chemical. 

5  NCHEM 

+ 

Number  of  dissolved  chemicals. 

6  NSSIZE 

+ 

Number  of  sediment  sizes. 

7  IDTYPT(NP,i)  + 

id  of  xy  series  to  describe  the  time-dependent  concentration  profile  associated 
with  the  Dirichlet  boundary  node  for  the  particulate  chemical  on  the 

suspended  sediment,  where  i  =  NCHEM  +  NSSIZE  +  (j-l)*NCHEM  +  k, 
j  e[l, NSSIZE],  andk  e[l,  NCHEM]. 

FB  Card 

Flux-tvne  boundary  parameters 

Field  Variable 

Value 

Description 

C  1-2  IC1 

FB 

Card  group  identifier. 

C  3  IC3 

1 

Flux-type  boundary  conditions  for  dissolved  chemicals. 

1  NS 

+ 

id  of  flux-type  boundary  side. 

2  NSCBT(NS,1)  + 

id  of  global  node  corresponding  to  the  1st  node  of  the  flux-type  boundary 
side. 

3  NSCBT(NS,2) 

+ 

id  of  global  node  corresponding  to  the  2nd  node  of  the  flux-type  boundary 
side. 

4  NSCBT(NS,3) 

Index  of  boundary  condition  type  for  the  flux-type  boundary  side. 

1 

This  is  a  Variable  boundary  side  with  the  time-dependent  concentration 
specified  if  the  flow  is  incoming. 

2 

This  is  a  Cauchy  boundary  side  with  the  time-dependent  Cauchy  flux 
specified. 

3 

This  is  a  Neumann  boundary  side  with  the  time-dependent  Neumann  flux 
specified. 

4 

This  is  a  river/stream-related  or  a  river/stream  junction-related  boundary  side. 
The  associated  boundary  conditions  is  a  Variable  boundary  condition. 
However,  the  concentrations  along  with  the  inward  flow  are  not  prescribed. 
Rather  they  are  the  concentrations  at  the  associated  river/stream  nodes  or 
river/stream  junction  for  the  time  being. 

5  i 

+ 

id  of  dissolved  Chemical. 

6  ICTYPT(NS,i)  + 

id  of  xy  series  to  describe  the  time-dependent  profile  associated  with  the  flux 

-type  boundary  side  for  the  dissolved  chemical.  It  is 

(1)  a  concentration  profile  when  NSCBT(j,2)  =  1. 

(2)  a  Cauchy  flux  profile  when  NSCBT(j,2)  =  2. 

(3)  a  Neumann  flux  profile  when  NSCBT(j,2)  =  3. 

Field  Variable  Value  Description 

C 1-2  IC1  FB  Card  group  identifier. 
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C  3  IC3  2 

1  NS  + 

2  NSCBT(NS,1)  + 

3  NSCBT(NS,2)  + 

4  NSCBT(NS,3) 

1 

2 

3 

4 


5 

k 

+ 

6 

NCHEM 

+ 

7 

ICTYPT(NS,i) 

+ 

Field 

Variable 

Value 

C  1-2 

IC1 

FB 

C3 

IC3 

3 

1 

NS 

+ 

2 

NSCBT(NS,1) 

+ 

3 

NSCBT(NS,2) 

4* 

4  NSCBT(NS,3) 

1 


2 

3 

4 


Flux-type  boundary  conditions  for  suspended  sediments, 
id  of  flux-type  boundary  side. 

id  of  global  node  corresponding  to  the  1st  node  of  the  flux-type  boundary 
id  of  global  node  corresponding  to  the  2nd  node  of  the  flux-type  boundary 


side. 

Index  of  boundary  condition  type  for  the  flux-type  boundary  side. 

This  is  a  Variable  boundary  side  with  the  time-dependent  concentration 
specified  if  the  flow  is  incoming. 

This  is  a  Cauchy  boundary  side  with  the  time-dependent  Cauchy  flux 

This  is  a  Neumann  boundary  side  with  the  time-dependent  Neumann  flux 

This  is  a  river/stream-related  or  a  river/stream  junction-related  boundary  side. 
The  associated  boundary  conditions  is  a  Variable  boundary  condition. 
However,  the  concentrations  along  with  the  inward  flow  are  not  prescribed. 
Rather  they  are  the  concentrations  at  the  associated  river/stream  nodes  or 


river/stream  junction  for  the  time  being, 
id  of  suspended  sediment  size. 

Number  of  dissolved  chemicals. 

id  of  xy  series  to  describe  the  time-dependent  profile  associated  with  the  flux 
-type  boundary  side  for  the  suspended  sediment,  where  i  =  NCHEM+k.  It 
is 


(1)  a  concentration  profile  when  NSCBT(j,2)  =  1. 

(2)  a  Cauchy  flux  profile  when  NSCBT(j,2)  =  2. 

(3)  a  Neumann  flux  profile  when  NSCBT(j,2)  =  3. 


Description 

Card  group  identifier. 

Flux-type  boundary  conditions  for  particulate  chemicals  on  suspended 
sediments. 

id  of  flux-type  boundary  side. 

id  of  global  node  corresponding  to  the  1st  node  of  the  flux-type  boundary 

side.  „  .  ,  , 

id  of  global  node  corresponding  to  the  2nd  node  of  the  flux-type  boundary 

side.  .  ( 

Index  of  boundary  condition  type  for  the  flux-type  boundary  side. 

This  is  a  Variable  boundary  side  with  the  time-dependent  concentration 
specified  if  the  flow  is  incoming. 

This  is  a  Cauchy  boundary  side  with  the  time-dependent  Cauchy  flux 
specified . 

This  is  a  Neumann  boundary  side  with  the  time-dependent  Neumann  flux 
specified. 

This  is  ariver/stream-related  or  a  river/ stream  junction-related  boundary  side. 
The  associated  boundary  conditions  is  a  Variable  boundary  condition. 
However,  the  concentrations  along  with  the  inward  flow  are  not  prescribed. 
Rather  they  are  the  concentrations  at  the  associated  river/stream  nodes  or 
river/stream  junction  for  the  time  being. 
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5 

j 

+ 

id  of  suspended  sediment  size. 

6 

k 

+ 

id  of  particulate  chemical. 

7 

NCHEM 

+ 

Number  of  dissolved  chemicals. 

8 

NSSIZE 

+ 

Number  of  sediment  sizes. 

9 

ICTYPT(NS,i) 

+ 

id  of  xy  series  to  describe  the  time-dependent  profile  associated  with  the  flux 

-type  boundary  side  for  the  particulate  chemical  on  the  suspended  sediment, 
where  i  =  NCHEM  +  NSSIZE  +  (j-l)*NCHEM  +  k,  j  e[l,  NSSIZE],  and  k 
e[l,  NCHEM].  It  is 

(1)  a  concentration  profile  when  NSCBT(j,2)  =  1. 

(2)  a  Cauchy  flux  profile  when  NSCBT(j,2)  =  2. 

(3)  a  Neumann  flux  profile  when  NSCBT(j,2)  =  3. 

RS  card  Rainfall  source  parameters 

Field  Variable  Value  Description 

C 1-2  IC1  RS  Card  group  identifier. 

C  3  IC3  1  Rainfall  source  profile  for  dissolved  chemicals. 

1st  line  includes  two  records  as  follows. 

1  M  +  id  of  2-D  element. 

2  NCHEM  +  Number  of  dissolved  chemicals. 

2nd  line  includes  NCHEM  records  as  follows. 

1  IRC(M,1)  +  id  of  xy  series  to  describe  the  time-dependent  concentration  profile  for  the 

1st  dissolved  chemical  in  the  rainfall  that  falls  on  the  M®  2-D  element. 

2  IRC(M,2)  +  id  of  xy  series  to  describe  the  time-dependent  concentration  profile  for  the 

2nd  dissolved  chemical  in  the  rainfall  that  falls  on  the  M®  2-D  element. 

Up  to  for  the  NCHEM®  dissolved  chemical  on  the  M®  2-D  element. 


IC  card 

Initial 

condition  parameters 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

IC 

Card  group  identifier. 

C  3 

IC3 

1 

Initial  condition  parameters. 

1 

IDCONC 

id  of  initial  concentrations. 

0 

constant  initial  concentrations. 

1 

variable  initial  concentrations. 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

IC 

Card  group  identifier. 

C  3 

IC3 

2 

Initially  constant  conditions  for  dissolved  chemicals. 

1 

j 

+ 

id  of  the  dissolved  chemical  being  input. 

2 

CCONST(j) 

+ 

Specified  initial  concentration  for  the  dissolved  chemical.  [M/L3] 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

IC 

Card  group  identifier. 

C3 

IC3 

3 

Initially  constant  conditions  for  particulate  chemicals  on  suspended  sediments 

1 

j 

+ 

id  of  the  particulate  chemical  being  input. 

2 

i 

+ 

id  of  the  suspended  sediment  size  where  the  particulate  chemical  is. 

3 

NCHEM 

+ 

Number  of  dissolved  chemicals. 

4 

CCONST(k) 

+ 

Specified  initial  concentration  for  the  particulate  chemical  on  suspended 
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M  co  »n 


sediment  being  input,  where  k  =  i*NCHEM  +  j.  [M/L3] 


Field  Variable 
C  1-2  IC1 
C  3  IC3 

1  j 

i 

NCHEM 
NSSIZE 
CCONST(k) 


Value  Description 
IC  Card  group  identifier. 

4  Initially  constant  conditions  for  particulate  chemicals  on  bed  sediments 
+  id  of  the  particulate  chemical  being  input. 

+  id  of  the  bed  sediment  size  where  the  particulate  chemical  is. 

+  Number  of  dissolved  chemicals. 

+  Number  of  sediment  sizes. 

+  Specified  initial  concentration  for  the  particulate  chemical  on  the  bed 
sediment  being  input,  where  k  —  (i+NSSIZE)*  NCHEM  +  j  [M/L  ]. 


Field  Variable 
C  1-2  IC1 
C  3  IC3 

1  i 

2  SCONST(i) 


Value  Description 
IC  Card  group  identifier. 

5  Initially  constant  conditions  for  suspended  sediments. 

+  id  of  the  suspended  sediment  size  being  input. 

+  Specified  initial  concentration  for  the  suspended  sediment  of  the  i  size. 
[M/L3] 


Field  Variable 
C  1-2  IC1 
C  3  IC3 

1  i 

2  NSSIZE 

3  SCONST(k) 


Value  Description 
IC  Card  group  identifier. 

6  Initially  constant  conditions  for  bed  sediments. 

+  id  of  the  bed  sediment  size  being  input. 

+  Number  of  sediment  sizes. 

+  Specified  initial  concentration  for  the  bed  sediment  of  the  i  size,  where  k 
=  NSSIZE +  i.  [M/L3] 


XYCard 

Y-Y  Series  Parameters 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

XY 

Card  group  identifier. 

C  3 

IC3 

1 

Generation  of  any  x-y  series  function. 

1 

i 

+ 

Index  number  for  x-y  series. 

2 

NPOINT(i) 

+ 

The  number  of  x-y  values  in  the  series. 

3 

DELTAX 

0 

Dummy  values. 

4 

DELTAY 

0 

Dummy  values. 

5 

REPEAT 

0 

Dummy  values. 

6 

BEGCYC 

0 

Dummy  values. 

7  TNAME 

(new  line)X,Y 

+ 

A  character  string  representing  the  name  of  the  XY  series. 

After  XY  card,  the  x-y  values  of  the  series  are  listed  one  pair  per  line  up 
NPOINT(i). 

ENCard 

End  of  data  control 

Field 

Variable 

Value 

Description 

Cl-2 

IC1 

EN 

Card  group  identifier. 

C  3 

IC3 

D 

End  of  input  data. 

1.9.  File  9:  1-D  river/stream  transport  file  (.ltp  file) 
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Value 

WMS1TP 


Description 
File  type  identifier 


T1-T3  Cards  Job  title 

Only  one  Tl,  T2,  and  T3  card  can  be  used. 

OP  Card 
Field  Variable 
C  1-2  IC1 
C  3  IC3 
1  IDCHEM 


2  IDSED 


Value  Description 

OP  Card  group  identifier. 

2  Solver  specification. 

Index  of  using  mass  lumping  for  transport  simulations. 

0  No  mass  lumping. 

1  Mass  lumping. 

Index  of  using  linear  matrix  solver  for  transport  simulations. 

1  The  pointwise  iterative  matrix  solver. 

2  Preconditioned  Conjugate  Gradient  Method  (polynomial), 

3  Preconditioned  Conjugate  Gradient  Method  (Incomplete  Cholesky). 
Index  of  using  quadrature  for  numerical  integration. 

1  Nodal  quadrature  for  line  element  integration. 

2  Gaussian  quadrature  for  line  element  integration. 

Index  of  using  adapted  implicit-explicit  scheme  for  the  predictor  step. 
0  No. 

1  Yes. 


Field 

Variable 

Value 

Description 

C  1-2 

IC1 

OP 

Card  group  identifier. 

C  3 

IC3 

3 

Weighting  factor  for  transport  simulations. 

1 

WT 

0.5 

Time  derivative  weighting  factor  for  transport  simulation. 
Crank-Nicolson  central. 

1.0 

Backward  difference. 

2 

OMET 

Relaxation  parameter  for  solving  nonlinear  matrix  equations 

0.0- 1.0  Under  relaxation. 

1.0 

Exact  relaxation. 

1. 0-2.0  Over  relaxation. 

3  OMIT  Relaxation  parameter  for  solving  linearized  matrix  equation. 

0.0- 1.0  Under  relaxation. 

1.0  Exact  relaxation. 

1 .0-2.0  Over  relaxation. 


Field  Variable 
C  1-2  IC1 
C  3  IC3 
1  ILUMPT 


2  IPNTST 


3  IQUART 


4  IADAPT 


Run  option  parameters 
Value  Description 
OP  Card  group  identifier. 

1  Simulation  selection. 

Index  of  chemical  transport  simulation. 
0  Chemical  transport  is  not  simulated. 

1  Chemical  transport  is  simulated. 

Index  of  sediment  transport  simulation. 
0  Sediment  transport  is  not  simulated. 

1  Sediment  transport  is  simulated. 
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Field  Variable 
C  1-2  IC1 
C  3  IC3 

1  IEIGENT 

2  GGT 


IP  Card 

Field  Variable 
C  1-2  IC1 
C  3  IC3 

1  NNITERT 

2  NPITER 

3  TOLBC 

4  TOLBS 


PT  Card 
Field  Variable 
C  1-2  IC1 
C  3  IC3 

1  NXWT 

2  IDETQT 


MPCard 

Field 

Variable 

C  1-2 

IC1 

C  3 

IC3 

1 

i 

2 

PROPT(l,i) 

3 

PROPT(2,i) 

SS  card 

Field 

Variable 

C  1-2 

IC1 

C  3 

IC3 

1 

NP 

2 

j 

3 

rrsR(NP,j) 

Field 

Variable 

C  1-2 

IC1 

Value  Description 
OP  Card  group  identifier. 

4  Preconditioned  Conjugate  Gradient  method. 

0  GGT  will  not  be  read. 

1  GGT  will  be  read. 

+  Upper  bound  of  the  maximum  eigenvalue  of  the  coefficient  matrix  used  in 
the  Preconditioned  Conjugate  Gradient  method. 

Iteration  Parameters 
Value  Description 
IP  Card  group  identifier. 

1  Total  simulation  time. 

+  Allowed  number  for  the  non-linear  iteration. 

+  Allowed  number  for  the  linearized  iteration. 

+  Allowed  relative  error  for  getting  convergent  transport  solutions  for  both 
dissolved  and  particulate  chemicals. 

+  Allowed  relative  error  for  getting  convergent  transport  solutions  for 
sediments. 

Particle  tracking  parameters 
Value  Description 
PT  Card  group  identifier. 

1  Particle  tracking  controlling  parameters. 

+  Subelement  number  used  in  the  X-direction  in  the  “in-element  particle 
tracking. 

Index  of  particle  tracking  approach. 

1  Using  the  average-velocity  approach. 

2  Using  the  constant-velocity  approach. 

Material  property  parameters 
Value  Description 
MP  Card  group  identifier. 

1  Material  property  for  transport. 

+  id  of  material  type. 

+  Longitudinal  dispersivity  associated  with  the  material  type  [L]. 

+  Pure  diffusion  coefficient  associated  with  the  material  type  [L2/T]. 

Snurce/sink  parameters 
Value  Description 
SS  Card  group  identifier. 

1  Source/sink  profile  for  dissolved  chemicals. 

+  id  of  global  node. 

+  id  of  dissolved  chemical. 

+  id  of  xy  series  to  describe  the  time-dependent  source/sink  profile  for  the 
dissolved  chemical  at  the  global  node. 

Value  Description 
SS  Card  group  identifier. 
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C  3 

IC3 

2 

Source/sink  profile  for  suspended  sediment. 

1 

NP 

+ 

id  of  global  node. 

2 

j 

+ 

id  of  suspended  sediment  size. 

3 

NCHEM 

+ 

Number  of  dissolved  chemicals. 

4 

ITSR(NP,m) 

+ 

id  of  xy  series  to  describe  the  time-dependent  source/sink  profile  for  the 
suspended  sediment  size  at  the  global  node,  where  m  =  NCHEM  +j. 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

SS 

Card  group  identifier. 

C  3 

IC3 

3 

Source/sink  profile  for  particulate  chemicals  on  suspended  sediments. 

1 

NP 

+ 

id  of  global  node. 

2 

j 

+ 

id  of  suspended  sediment. 

3 

k 

+ 

id  of  particulate  chemical. 

4 

NCHEM 

+ 

Number  of  dissolved  chemicals. 

5 

NSSIZE 

+ 

Number  of  sediment  sizes. 

6 

ITSR(NP,m) 

+ 

id  of  xy  series  to  describe  the  time-dependent  source/sink  profile  for  the 
particulate  chemical  on  the  suspended  sediment  size  at  the  global  node, 
where  m  =  NCHEM  +  NSSIZE  +  (j-l)*NCHEM  +  k,  j  ell, NSSIZE],  and 
k  e[l,  NCHEM]. 

UB  Card 
Field  Variable 
C  1-2  IC1 
C  3  IC3 

1  NP 

2  NPDBT(NP,1) 

3  NPDBT(NP,2) 


4 

5 


IDTYPT(NP,i) 


UB 

1 

+ 

+ 

1 


User-specified  boundary  parameters 
Value  Description 

Card  group  identifier. 

User-specified  boundary  conditions  for  dissolved  chemicals, 
id  of  user-specified  boundary  node. 

id  of  global  node  corresponding  to  the  user-specified  boundary  node. 
Index  of  boundary  condition  type  for  the  user-specified  boundary  node. 
This  is  a  Dirichlet  boundary  node  with  the  time-dependent  concentration 
specified. 

This  is  a  Variable  boundary  node  with  the  time-dependent  concentration 
specified  if  the  flow  is  incoming. 

This  is  a  Cauchy  boundary  node  with  the  time-dependent  Cauchy  flux 
specified. 

This  is  a  Neumann  boundary  node  with  the  time-dependent  Neumann  flux 
specified. 

id  of  dissolved  Chemical. 

id  of  xy  series  to  describe  the  time-dependent  profile  associated  with  the 
user-specified  boundary  node  for  the  dissolved  chemical.  It  is 

(1)  a  concentration  profile  when  NPDB(j,2)  =  1. 

(2)  a  concentration  profile  when  NPDB(j,2)  =  2. 

(3)  a  Cauchy  flux  profile  when  NPDB(j,2)  =  3. 

(4)  a  Neumann  flux  profile  when  NPDB(j,2)  =  4. 


Field 
C  1-2 
C  3 
1 
2 


Variable  Value 
IC1  UB 

IC3  2 

NP  + 

NPDBT(NP,1)  + 


Description 

Card  group  identifier. 

User-specified  boundary  conditions  for  suspended  sediments, 
id  of  user-specified  boundary  node. 

id  of  global  node  corresponding  to  the  user-specified  boundary  node. 
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00  O  -fc* 


3  NPDBT(NP.2) 

1 

2 

3 

4 

4  k  + 

5  NCHEM  + 

6  IDTYPT(NP,i)  + 


Field  Variable  Value 

C  1-2  IC1  UB 

C  3  IC3  3 

1  NP  + 

2  NPDBT(NP,1)  + 

3  NPDBT(NP,2) 

1 

2 

3 

4 


j 

+ 

k 

+ 

NCHEM 

+ 

NSSIZE 

+ 

IDTYPT(NP,i)  + 

Index  of  boundary  condition  type  for  the  user-specified  boundary  node. 
This  is  a  Dirichlet  boundary  node  with  the  time-dependent  concentration 
specified. 

This  is  a  Variable  boundary  node  with  the  time-dependent  concentration 
specified  if  the  flow  is  incoming. 

This  is  a  Cauchy  boundary  node  with  the  time-dependent  Cauchy  flux 
specified. 

This  is  a  Neumann  boundary  node  with  the  time-dependent  Neumann  flux 
specified. 

id  of  suspended  sediment  size. 

Number  of  dissolved  chemicals. 

id  of  xy  series  to  describe  the  time-dependent  profile  associated  with  the 
user-specified  boundary  node  for  the  suspended  sediment,  where  i  — 
NCHEM+k.  It  is 

(1)  a  concentration  profile  when  NPDBT(j,2)  =  1. 

(2)  a  concentration  profile  when  NPDBT(j,2)  =  2. 

(3)  a  Cauchy  flux  profile  when  NPDBT(j,2)  =  3. 

(4)  a  Neumann  flux  profile  when  NPDBT(j,2)  =  4. 

Description 

Card  group  identifier. 

User-specified  boundary  conditions  for  particulate  chemicals  on  suspended 
sediments. 

id  of  user-specified  boundary  node. 

id  of  global  node  corresponding  to  the  user-specified  boundary  node. 

Index  of  boundary  condition  type  for  the  user-specified  boundary  node. 
This  is  a  Dirichlet  boundary  node  with  the  time-dependent  concentration 
specified. 

This  is  a  Variable  boundary  node  with  the  time-dependent  concentration 
specified  if  the  flow  is  incoming. 

This  is  a  Cauchy  boundary  node  with  the  time-dependent  Cauchy  flux 
specified. 

This  is  a  Neumann  boundary  node  with  the  time-dependent  Neumann  flux 
specified. 

id  of  suspended  sediment  size, 
id  of  particulate  chemical. 

Number  of  dissolved  chemicals. 

Number  of  sediment  sizes. 

id  of  xy  series  to  describe  the  time-dependent  profile  associated  with  the 
user-specified  boundary  node  for  the  particulate  chemical  on  the  suspended 
sediment,  where  i  —  NCHEM  +  NSSIZE  +  (j-l)*NCHEM  +  k,  j  € 
[1, NSSIZE],  andk  €  [1,  NCHEM].  It  is 

(1)  a  concentration  profile  when  NPDBT(j,2)  =  1. 

(2)  a  concentration  profile  when  NPDBT(j,2)  =  2. 

(3)  a  Cauchy  flux  profile  when  NPDBT(j,2)  =  3. 

(4)  a  Neumann  flux  profile  when  NPDBT(j,2)  =  4. 


RS  card  Rainfall  source  parameters 
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Field  Variable  Value  Description 

C 1-2  IC1  RS  Card  group  identifier. 

C  3  IC3  1  Rainfall  source  profile  for  dissolved  chemicals. 

1”  line  includes  two  records  as  follows. 

1  M  +  id  of  1-D  element. 

2  NCHEM  +  Number  of  dissolved  chemicals. 

2nd  line  includes  NCHEM  records  as  follows. 

1  IRC(M,1)  +  id  of  xy  series  to  describe  the  time-dependent  concentration  profile  for  the 

1st  dissolved  chemical  in  the  rainfall  that  falls  on  the  M*  1-D  element. 

2  IRC(M,2)  +  id  of  xy  series  to  describe  the  time-dependent  concentration  profile  for  the 

2nd  dissolved  chemical  in  the  rainfall  that  falls  on  the  M*  1-D  element. 

Up  to  for  the  NCHEM,h  dissolved  chemical  on  the  M*  1-D  element. 


IC  card 

Initial  condition  parameters 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

IC 

Card  group  identifier. 

C  3 

IC3 

1 

Initial  condition  parameters. 

1 

IDCONC 

0 

id  of  initial  concentrations, 
constant  initial  concentrations. 

1 

variable  initial  concentrations. 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

IC 

Card  group  identifier. 

C  3 

IC3 

2 

Initially  constant  conditions  for  dissolved  chemicals 

1 

j 

+ 

id  of  the  dissolved  chemical  being  input. 

2 

CCONST(j) 

+ 

Specified  initial  concentration  for  the  dissolved  chemical  [M/L3]. 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

IC 

Card  group  identifier. 

C  3 

IC3 

3 

Initially  constant  conditions  for  particulate  chemicals  on  suspended 
sediments 

1 

j 

+ 

id  of  the  particulate  chemical  being  input. 

2 

i 

+ 

id  of  the  suspended  sediment  size  where  the  particulate  chemical  is. 

3 

NCHEM 

+ 

Number  of  dissolved  chemicals. 

4 

CCONST(k) 

+ 

Specified  initial  concentration  for  the  particulate  chemical  on  suspended 
sediment  being  input,  where  k  =  i*NCHEM  +  j  [M/L3]. 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

IC 

Card  group  identifier. 

C  3 

IC3 

4 

Initially  constant  conditions  for  particulate  chemicals  on  bed  sediments 

1 

j 

+ 

id  of  the  particulate  chemical  being  input. 

2 

i 

+ 

id  of  the  bed  sediment  size  where  the  particulate  chemical  is. 

3 

NCHEM 

+ 

Number  of  dissolved  chemicals. 

4 

NSSIZE 

+ 

Number  of  sediment  sizes. 

5 

CCONST(k) 

+ 

Specified  initial  concentration  for  the  particulate  chemical  on 
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the  bed  sediment  being  input,  where  k  —  (i+NSSIZE)*  NCHEM  +  j  [M/L  ]. 


Field 

Variable 

Value 

Description 

C  1-2 

IC1 

IC 

Card  group  identifier. 

C  3 

IC3 

5 

Initially  constant  conditions  for  suspended  sediments. 

1 

i 

+ 

id  of  the  suspended  sediment  size  being  input. 

2 

SCONST(i) 

+ 

Specified  initial  concentration  for  the  suspended  sediment  of  the  i*  size 

[M/L3]. 

Field 

Variable 

Value 

Description 

G  1-2 

IC1 

IC 

Card  group  identifier. 

C  3 

IC3 

6 

Initially  constant  conditions  for  bed  sediments. 

1 

i 

+ 

id  of  the  bed  sediment  size  being  input. 

2 

NSSIZE 

+ 

Number  of  sediment  sizes. 

3 

SCONST(k) 

+ 

Specified  initial  concentration  for  the  bed  sediment  of  the  i  size,  where  k 

=  NSSIZE  +  i  [M/L3]. 

XY  Card 

X-Y  Series  Parameters 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

XY 

Card  group  identifier. 

C  3 

IC3 

1 

Generation  of  any  x-y  series  function. 

1 

i 

+ 

Index  number  for  x-y  series. 

2 

NPOINT(i) 

+ 

The  number  of  x-y  values  in  the  series. 

3 

DELTAX 

0 

Dummy  values. 

4 

DELTAY 

0 

Dummy  values. 

5 

REPEAT 

0 

Dummy  values. 

6 

BEGCYC 

0 

Dummy  values. 

7 

TNAME 

+ 

A  character  string  representing  the  name  of  the  XY  series. 

(new  line)X,Y 

After  XY  card,  the  x-y  values  of  the  series  are  listed  one  pair  per  line  up 

to  NPOINT(i). 

ENCard 

F.nd  of  data  control 

Field 

Variable 

Value 

Description 

Cl-2 

IC1 

EN 

Card  group  identifier. 

C  3 

IC3 

D 

End  of  input  data. 

1.10.  File  10:  l-D/2 

-D/3-D  chemistry/sediment  file  (.che  file) 

Value 

Description 

WMSCHE 

File  type  identifier 

T1-T3  Cards 

Job  title 

Only  one  Tl,  T2,  and  T3  card  can  be  used. 

RX  card 

Chemical  reaction  narameters 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

RX 

Card  group  identifier. 
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C  3  IC3 

1 

Numbers  of  reactions  and  chemicals 

1  NRXN 

+ 

Number  of  reactions. 

2  NCHEM 

+ 

Number  of  dissolved  chemicals  in  1-D/2-D/3-D  systems. 

3  NRXNS 

+ 

Number  of  adsorption  reactions  in  the  subsurface. 

4  NSITE 

+ 

Number  of  adsorbing  site  in  the  subsurface. 

5  NSORB 

+ 

Number  of  adsorbed  chemicals  in  the  subsurface. 

Field  Variable 

Value 

Description 

C  1-2  IC1 

RX 

Card  group  identifier. 

C  3  IC3 

2 

Chemical  names 

1  NCHEM 

+ 

Number  of  dissolved  Chemical. 

Note:  NCHEM  new  lines  are  needed. 

(Each  line  contains  the  following  data:  I5,5X,A20) 

1  J 

+ 

id  of  the  dissolved  chemical  being  input. 

2  CHEMN(J) 

+ 

Name  of  the  J*  dissolved  chemical. 

Field  Variable 

Value 

Description 

C  1-2  IC1 

RX 

Card  group  identifier. 

C  3  IC3 

3 

Adsorbing  site  names 

1  NSITE 

+ 

Number  of  adsorbing  sites. 

Note:  NSITE  new  lines  are  needed. 

(Each  line  contains  the  following  data:  I5,5X,A20) 

1  J 

+ 

id  of  the  dissolved  chemical  being  input. 

2  ASITEN(J) 

+ 

Name  of  the  J*  adsorbing  site. 

Field  Variable 

Value 

Description 

C  1-2  IC1 

RX 

Card  group  identifier. 

C  3  IC3 

4 

Adsorbed  chemical  names 

1  NSORB 

+ 

Number  of  adsorbed  chemicals. 

Note:  NSORB  new  lines  are  needed. 

(Each  line  contains  the  following  data:  I5,5X,A20) 

1  J 

+ 

id  of  the  dissolved  chemical  being  input. 

2.  ASORBN(J) 

+ 

Name  of  the  J*  adsorbed  chemical. 

Field  Variable 

Value 

Description 

C  1-2  IC1 

RX 

Card  group  identifier. 

C  3  IC3 

5 

Reaction  rate  constants  and  stoichiometry  for  aqueous  complexation 

reactions  in  1-D/2-D/3-D  systems. 

1  j 

+ 

id  of  aqueous  complexation  reaction. 

2  NCHEM 

+ 

Number  of  dissolved  chemicals. 

3  FKRX(j) 

+ 

Forward  reaction  rate  constant  of  the  reaction,  [reaction  dependent] 

4  BKRX(j) 

+ 

Backward  reaction  rate  constant  of  the  reaction,  [reaction  dependent] 

Note:  Two  new  lines  are  needed, 
(the  first  new  line) 
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1 

2 


NURTS(j,l)  + 
NURTS(j,2)  + 


Stoichiometric  coefficient  of  the  1st  dissolved  chemical  (on  the  reactant  side) 
in  the  reaction. 

Stoichiometric  coefficient  of  the  2nd  dissolved  chemical  (on  the  reactant  side) 
in  the  reaction. 


Up  to  NURTS(j,NCHEM) 
(the  second  new  line) 

1  NUPDS(j,l)  + 

2  NUPDS(j,2)  + 


Stoichiometric  coefficient  of  the  1st  dissolved  chemical  (on  the  product  side) 
in  the  reaction. 

Stoichiometric  coefficient  of  the  2nd  dissolved  chemical  (on  the  product  side) 
in  the  reaction. 


Up  to  NUPDS(j  ,NCHEM) 


Field  Variable 
C  1-2  IC1 
C3  IC3 

1  j 

2  NCHEM 

3  NSITE 

4  NSORB 

5  FKRXSS(j) 

6  BKRXSS© 


Value  Description 

RX  Card  group  identifier.  . 

6  Reaction  rate  constants  and  stoichiometry  for  adsorption  reactions  in  the  3-D 

subsurface  system. 

+  id  of  adsorption  reaction. 

+  Number  of  dissolved  chemicals. 

+  Number  of  adsorbing  sites  in  the  subsurface. 

+  Number  of  adsorbed  chemicals  in  the  subsurface. 

+  Forward  reaction  rate  constant  of  the  reaction,  [reaction  dependent] 

+  Backward  reaction  rate  constant  of  the  reaction,  [reaction  dependent] 


Note:  Two  new  lines  are  needed. 


(the  first  new  line) 

1  NURTSS(j,l)  + 

2  NURTSS(j,2)  + 
NURTSS(j,NCHEM) 

NURTSS(j,NCHEM+l) 


Stoichiometric  coefficient  of  the  1st  dissolved  chemical  (on  the  reactant  side) 
in  the  reaction. 

Stoichiometric  coefficient  of  the  2nd  dissolved  chemical  (on  the  reactant  side) 
in  the  reaction. 

Stoichiometric  coefficient  of  the  NCHEM111  dissolved  chemical  (on  the 
reactant  side)  in  the  reaction. 

Stoichiometric  coefficient  of  the  1st  adsorbing  site  (on  the  reactant  side)  in 


the  reaction.  _ 

NURTSS(j,NCHEM+NSITE)  Stoichiometric  coefficient  of  the  NSITE*  adsorbing  site  (on  the  reactant 

side)  in  the  reaction. 

NURTSS(j,NCHEM+NSlTE+l)Stoichiometric  coefficient  of  the  1st  adsorbed  chemical  (on  the  reactant  side) 

in  the  reaction. 


up  to  NURTSS(j,NCHEM+NSITE+NSORB) 


(the  second  new  line) 

1  NUPDSS(j,l)  + 

2  NUPDSS(j,2)  + 
NUPDSS(j  ,NCHEM) 


Stoichiometric  coefficient  of  the  1st  dissolved  chemical  (on  the  product  side) 
in  the  reaction. 

Stoichiometric  coefficient  of  the  2nd  dissolved  chemical  (on  the  product  side) 
in  the  reaction. 

Stoichiometric  coefficient  of  the  NCHEM*  dissolved  chemical  (on  the 
product  side)  in  the  reaction. 
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NUPDSS(j,NCHEM+l) 


Stoichiometric  coefficient  of  the  1“  adsorbing  site  (on  the  product 
side)  in  the  reaction. 

NUPDSS(j,NCHEM+NSITE)  Stoichiometric  coefficient  of  the  NSITE*  adsorbing  site  (on  the 

product  side)  in  the  reaction. 

NUPDSS(j,NCHEM+NSITE+l)  Stoichiometric  coefficient  of  the  1st  adsorbed  chemical  (on  the 

product  side)  in  the  reaction. 

up  to  NUPDS(j,NCHEM+NSITE+NSORB) 


ST  card 

Sediment  parameters 

Field 

Variable 

Description 

C  1-2 

IC1 

ST 

Card  group  identifier. 

C  3 

IC3 

1 

Number  of  sediment  sizes 

1 

NSSIZE 

+ 

Number  of  sediment  sizes. 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

ST 

Card  group  identifier. 

C  3 

IC3 

2 

Parameter  associated  with  each  sediment  size. 

1 

j 

+ 

id  of  Sediment  size. 

2 

SPARA(j,l) 

1 

The  type  of  the  sediment  size. 

Cohesive  sediment,  e.g.,  clay  and  silt. 

2 

Non-cohesive  sediment,  e.g.,  sand. 

3 

SPARA(j,2) 

+ 

Settling  speed  of  the  sediment  size  [L/T] . 

4 

SPARA(j,3) 

+ 

Critical  shear  stress  for  deposition  of  the  sediment  size  [M/L/T2] . 

5 

SPARA(j,4) 

+ 

Critical  shear  stress  for  erosion  of  the  j*  size  fraction  of  sediment 
[M/L/T2]. 

6 

SPARA(j,5) 

+ 

Erodibility  of  the  sediment  size  [M/L2]. 

7 

SPARA(j,6) 

+ 

Specific  weight  of  the  sediment  size  [M/L3]. 

8 

SPARA(j,7) 

+ 

Median  diameter  of  particles  in  mixture  of  the  sediment  size  [L]. 

9 

SPARA(j,8) 

+ 

Critical  bottom  shear  stress  of  the  sediment  size  at  which  sediment 
movement  begins  [M/L/T2]. 

Field 

Variable 

Value 

Descritrtion 

C  1-2 

IC1 

ST 

Card  group  identifier. 

C  3 

IC3 

3 

Sorption  rate  constants  and  stoichiometry  related  to  suspended 
sediment. 

1 

j 

+ 

id  of  suspended  sediment  size. 

2 

i 

+ 

id  of  dissolved  chemical. 

3 

FKSPSS(j,i) 

+ 

Forward  rate  constant  of  the  sorption  of  i*  dissolved  chemical  onto 
the  suspended  sediment  of  the  j*  size  [L3/M/T]. 

4 

BKSPSS(j,i) 

+ 

Backward  rate  constant  of  the  sorption  of  i*  dissolved  chemical  onto 
the  suspended  sediment  of  the  j*  size  [1/T|. 

Field 

Variable 

Value 

Descritrtion 

C  1-2 

IC1 

ST 

Card  group  identifier. 

C  3 

IC3 

4 

Sorption  rate  constants  and  stoichiometry  related  to  bed  sediment. 

1 

j 

+ 

id  of  bed  sediment  size. 
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2 

3 


i  + 

FKSPBS(j,i)  + 

4  BKSPBS(j,i)  + 


id  of  dissolved  chemical. 

Forward  rate  constant  of  the  sorption  of  i*  dissolved  chemical  onto 
the  bed  sediment  of  the  j*  size  [L3/M/T] . 

Backward  rate  constant  of  the  sorption  of  i*  dissolved  chemical  onto 
the  bed  sediment  of  the  j*  size  [1/T]. 


VO  card 
Field  Variable 
C 1-2  IC1 
C  3  IC3 

1  j 

2  IAP(j) 

3  FKVO(j) 

4  BKVO(j) 


Volatilization  parameters 

Value  Description 

VO  Card  group  identifier. 

1  Volatilization  rate  constants. 

+  id  of  dissolved  chemical. 

+  id  of  xy  series  to  describe  the  time-dependent  partial  atmospheric 

pressure  profile  of  the  dissolved  chemical  [atm]. 

+  Forward  volatilization  rate  constant  of  the  dissolved  chemical  [  1/T] . 

+  Backward  volatilization  rate  constant  of  the  dissolved  chemical 

[M/atm/L3/T]. 


DYcard 
Field  Variable 
C  1-2  IC1 
C  3  IC3 

1  j 

2  DCY(j) 


1 M  order  decay  parameters 

Value  Description 

DY  Card  group  identifier. 

1  Decay  constants  of  dissolved  chemicals. 

+  id  of  dissolved  chemical. 

+  1st  order  decay  constant  of  the  dissolved  chemical  [1/T]. 


Field 

Variable 

Value 

C  1-2 

IC1 

DY 

C  3 

IC3 

2 

1 

j 

+ 

2 

i 

+ 

3 

NCHEM 

+ 

4 

DCY(k) 

+ 

Description 

Card  group  identifier. 

Decay  constants  of  particulate  chemicals  on  suspended  sediments, 
id  of  sediment  size, 
id  of  particulate  chemical. 

Number  of  dissolved  chemicals. 

Decay  constant  of  the  particulate  chemical  on  the  suspended 
sediment  [1/T].  Where  k  =  NCHEM xj  +  i. 


Field 

Variable 

Value 

C  1-2 

IC1 

DY 

C  3 

IC3 

3 

1 

j 

+ 

2 

i 

+ 

3 

NCHEM 

+ 

4 

NSSIZE 

+ 

5 

DCY(k) 

+ 

Description 

Card  group  identifier. 

Decay  constants  of  particulate  chemicals  on  bed  sediments, 
id  of  sediment  size, 
id  of  particulate  chemical. 

Number  of  dissolved  chemicals. 

Number  of  sediment  sizes. 

Decay  constant  of  the  particulate  chemical  on  the  bed  sediment 
[1/T].  Where  k  =  NCHEM  x  (j  +  NSSIZE)  +  i. 


Field 

Variable 

Value 

C  1-2 

IC1 

DY 

C  3 

IC3 

4 

1 

j 

+ 

2 

NCHEM 

Description 

Card  group  identifier. 

Decay  constants  of  adsorbing  sites  in  the  subsurface, 
id  of  adsorbing  site. 

Number  of  dissolved  chemicals. 
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3  NSSIZE 

+ 

Number  of  sediment  sizes. 

4  DCY(k) 

+ 

Decay  constant  of  the  adsorbing  site  in  the  subsurface  [1/T],  Where 
k  =  NCHEM  x  (2xNSSIZE  +l)+j. 

Field  Variable 

Value 

Description 

C  1-2  IC1 

DY 

Card  group  identifier. 

C  3  IC3 

5 

Decay  constants  of  adsorbed  chemicals  in  the  subsurface. 

1  j 

+ 

id  of  adsorbed  chemical. 

2  NCHEM 

+ 

Number  of  dissolved  chemicals. 

3  NSSIZE 

+ 

Number  of  sediment  sizes. 

4  NSITE 

+ 

Number  of  adsorbing  sites  in  the  subsurface. 

5  DCY(k) 

+ 

Decay  constant  of  the  adsorbed  chemical  in  the  subsurface  [1/T]. 
Where  k  =  NCHEM  x  (2xNSSIZE  +  1)  +  NSITE  +  j . 

XYCard 

X-Y  Series  Parameters 

Held  Variable 

Value 

Description 

Cl-2  IC1 

XY 

Card  group  identifier. 

C  3  IC3 

1 

Generation  of  any  x-y  series  function. 

1  i 

+ 

Index  number  for  x-y  series. 

2  NPOINT(i) 

+ 

The  number  of  x-y  values  in  the  series. 

3  DELTAX 

0 

Dummy  values. 

4  DELTAY 

0 

Dummy  values. 

5  REPEAT 

0 

Dummy  values. 

6  BEGCYC 

0 

Dummy  values. 

7  TNAME 

+ 

A  character  string  representing  the  name  of  the  XY  series. 

(new  line)X,Y 

After  XY  card,  the  x-y  values  of  the  series  are  listed  one  pair  per  line  up  to 
NPOINT(i). 

EN  Card 

End  of  data  control 

Field  Variable 

Value 

Description 

Cl-2  IC1 

EN 

Card  group  identifier. 

C  3  IC3 

D 

End  of  input  data. 

1.11.  File  11: 1-D/2-D/3-D  mapping  file  (.map  files) 

Value 

Description 

WMSMAP 

File  type  identifier 

T1-T3  Cards 

Job  title 

Only  one  Tl,  T2,  and  T3  card  can  be  used. 

CO  Card 

Manning  information 

Field  Variable 

Value 

Description 

Cl-2  IC1 

CO 

Card  group  identifier. 

C  3  IC3 

1 

River/stream-related  overland  nodes 

1  N 

+ 

id  of  global  river/stream  node. 

2  NP12(N) 

+ 

id  of  the  global  overland  node  that  is  associated  with  the  global  river/stream 
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node.  This  overland  node  will  be  excluded  in  overland  simulations. 


3 

NPS12(1JS0 

+ 

id  of  the  global  overland  node  that  serves  as  the  1st  overland  node  next  to  the 
global  river/stream  node.  This  overland  node  is  treated  as  a  boundary  node 

f 

or  overland  simulations. 

4 

NPS12(2,N) 

+ 

id  of  the  global  overland  node  that  serves  as  the  2nd  overland  node  next  to  the 
global  river/stream  node.  This  overland  node  is  treated  as  a  boundary  node 

for  overland  simulations. 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

CO 

Card  group  identifier. 

C  3 

IC3 

2 

Overland-related  subsurface  nodes 

1 

N 

+ 

id  of  global  overland  node. 

2 

NP23(N) 

+ 

id  of  the  global  subsurface  node  that  is  associated  with  the  global  overland 
node.  This  subsurface  node  is  located  on  the  top  boundary  of  the  subsurface 

domain. 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

CO 

Card  group  identifier. 

C  3 

IC3 

3 

Overland-related  subsurface  elements 

1 

M 

+ 

id  of  global  overland  element. 

2 

MTOP23(M) 

+ 

id  of  the  global  subsurface  element  that  is  associated  with  the  global  overland 
element.  This  subsurface  element  is  located  on  the  top  boundary  of  the 

subsurface  domain. 

Field 

Variable 

Value 

Description 

C  1-2 

IC1 

CO 

Card  group  identifier. 

C  3 

IC3 

4 

River/stream-related  subsurface  nodes. 

1 

N 

+ 

id  of  global  river/stream  node. 

2 

NNTOP13(N) 

+ 

Number  of  global  subsurface  nodes  that  are  associated  with  the  N*  global 

river/stream  node. 

(new  line) 

id  of  the  global  subsurface  node  that  serves  as  the  1st  node  associated  with 

1 

NTOP12(N,l) 

+ 

the  N*  global  river/stream  node. 

Up  to  NTOP 1 3(N,NRTOP(N» 

ENCard 

End  of  data  control 

Field 

Variable 

Value 

Description 

Cl-2 

IC1 

EN 

Card  group  identifier. 

C  3 

IC3 

D 

End  of  input  data. 
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Table  1.1  lists  necessary  parts  for  undergoing  different  simulations. 


Table  1.1  Data  files  required  to  achieve  numerical  simulations. 


Simulation  type 

Description 

Files  required 

1 

1-D  river/stream  flow 

Files  1  and  4 

2 

1-D  river/stream  transport 

Files  1, 4, 7,  and  10 

3 

1-D  river/stream  flow  and  transport 

Files  1, 4, 7,  and  10 

4 

2-D  overland  flow 

Files  2  and  5 

5 

2-D  overland  transport 

Files  2, 5,  8,  and  10 

6 

2-D  overland  flow  and  transport 

Files  2, 5, 8,  and  10 

7 

3-D  subsurface  flow 

Files  3  and  6 

S 

3-D  subsurface  transport 

Files  3, 6, 9,  and  10 

9 

3-D  subsurface  flow  and  transport 

Files  3, 6, 9,  and  10 

10 

1-D/2-D  flow 

Files  1, 2,4, 5,  and  11 

11 

2-D/3-D  flow 

Files  2, 3, 5, 6,  and  11 

12 

1-D/2-D/3-D  flow 

Files  1, 2, 3, 4, 5, 6,  and  1 1 

13 

1-D/2-D  flow  and  transport 

Files  1, 2, 4, 5, 7, 8, 10,  and  1 1 

14 

2-D/3-D  flow  and  transport 

Files  2, 3, 5, 6, 8, 9, 10,  and  1 1 

15 

1-D/2-D/3-D  flow  and  transport 

Files  1  through  1 1 

On  the  next  page,  we  give  brief  description  on  the  files  that  should  be  included  in  the  super  files  for 
achieving  desired  simulations.  For  any  of  the  above  fifteen  simulations,  one  needs  to  provide  three  super  files: 
one  for  1-D,  one  for  2-D,  and  the  other  one  for  3-D.  In  each  super  file,  the  BCFT  file  is  a  MUST  in  order  to 
read  in  the  simulation  control  index,  KMOD.  If  KMOD  is  zero,  it  means  there  is  no  simulation  for  the 
corresponding  dimension  and  no  other  files  are  needed  to  be  included  in  the  super  file.  If  KMOD  is  not  zero, 
the  GEOM  file  is  required.  If  KMOD  equals  2,  both  the  BCTT  and  CHEM  files  also  need  to  be  included  in 
the  super  file.  If  coupling  systems  are  considered  (1-D/2-D,  2-D/3-D,  or  1-D/2-D/3-D),  the  COMP  file  must 
be  contained  in  the  2-D  super  file.  If  variable  initial  conditions  are  to  be  read,  more  files  need  to  be  taken  into 
account  in  the  super  files,  as  stated  in  the  table  on  the  next  page. 
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Index  in  super  files 


GEOM  in  1-D  super  file 


BCFT  in  1-D  super  file 


BCTT  in  1-D  super  file 


ICWD  in  1-D  super  file 


ICWD  in  1-D  super  file 


ICQL  in  1-D  super  file 


ICQL  in  1-D  super  file 


ICON  in  1-D  super  file 


ICCN  in  1-D  super  file 


PRTF  in  1-D  super  file 


GEOM  in  2-D  super  file 


BCFT  in  2-D  super  file 


BCTT  in  2-D  super  file 


ICWD  in  2-D  super  file 


ICWD  in  2-D  super  file 


ICQL  in  2-D  super  file 


ICQL  in  2-D  super  file 


ICCN  in  2-D  super  file 


ICCN  in  2-D  super  file 


PRTF  in  2-D  super  file 


GEOM  in  3-D  super  file 


BCFT  in  3-D  super  file 


BCTT  in  3-D  super  file 


ICHD  in  3-D  super  file 


ICHD  in  3-D  super  file 


ICVL  in  3-D  super  file 


ICVL  in  3-D  super  file 


ICMC  in  3-D  super  file 


I  CMC  in  3-D  super  file 


ICCN  in  3-D  super  file 


ICCN  in  3-D  super  file 


PRTF  in  3-D  super  file 


CHEM  in  1-D,  2-D,  or  3-D  super  files 


input  Data  File  Type 


11,41,  or71 


COMP  in  2-D  super  file 


Input  Data  file  Description 


1-D  geometry  file 


1-D  transport  file 


1-D  initial  water  depth/stage 


1-D  initial  water  depth/stage 


1-D  initial  velocity 


1-D  initial  velocity 


1-D  initial  concentrations 


1-D  initial  concentrations 


2-D  geometry  file 


2-D  transport  file 


2-D  initial  water  depth/stage 


2-D  initial  water  depth/stage 


2-D  initial  velocity 


2-D  initial  velocity 


2-D  initial  concentrations 


2-D  initial  concentrations 


3-D  geometry  file 


3-D  transport  file 


3-D  initial  head 


3-D  initial  bead 


3-D  initial  velocity 


3-D  initial  velocity 


3-D  initial  moisture  content 


3-D  initial  moisture  content 


3-D  initial  concentrations 


3-D  initial  concentrations 


Chemistry  file 


1-D/2-D/3-D  interface  file 
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Appendix  IL  PROGRAM  STRUCTURE  AND  SUBROUTINE  DESCRIPTION 

In  this  appendix,  we  give  plots  showing  the  structure  of  the  computer  program  and  provide 
description  for  each  subroutine. 


n.l.  Program  structure 

1.  Main  program  and  subroutines  it  calls  to. 


MAIN 


FILES-3 

PAGEN.3 

SURF_3  | 

BCDATF 3 

BCDATT 3  J 

RINIT_3 

FL0W 3 

SFL0WF.3 

THN0DE.3 

j  PRINTT.3 

ST0RE 3D 

SPR0P_3  I- 

RHSCMP.3  - 

ADWK.3 

CKBDY 3 

DISPC.3 

TRANSP.3  |- 

FILES.2  | - 

FILESJ 

LNDGEN.2  |- - 

GE0M1DC 

PAGENJ2  | - 

PAGEN_1 

SURF.2 

N0DV_1 

TRILRN2M 

|  RINITJ 

IDFBS 

1  GRAD.l 

N0DV.2 

RAINOD.l 

RINIT_2 

BSHEAR_I 

GRAD_2 

DEPEROJ 

RAIN0D.2 

RHSCMP_I 

BSHEAR.2 

VELTJ  j 

DEPER0_2 

1 

NUDZO.l 

1 

RHSCMP.2 

1 

GEOPREP 

1 

KXKYNP2M 

1 

ST0RE_1D 

1 

VELT_2 

FLOW_l 

1 

NUDZ0.2 

1 

DISPC_1 

l 

ADWK_2 

f 

TRANSP.l 

l 

ST0RE_2D 

r 

PRINTTJ 

l 

FL0W_2 

FL0W2M0C 

DISPC.2 

TRANSP.2 

[  PRINTT_2  [ 

FACE23B 

FACE02C 

PFFCT1 

PFFCT2 

FLUX02C 

INF02S 
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2.  Subroutines  concerning  the  computation  of  water  flow, 


FLOW.l 


— I  pffcti 

— |  gradT" 

- 1  VELT_1~ 

— 1  geograd 
— 1  trak.vT 

- 1  nudzoT 

- 1  advbcf.T 

- 1  btrakfT 

- 1  JUNCTION 


|  FLOW.2 

- 1  GRAD_2 

- 1  VELT.2 

- 1  NUDZ0.2 

- 1  ADVBCF.2 

- 1  BTRAKF.2 

FLOW2MOC 


GRAD.2 


KXKYNP2M 


ADVBCF2M 


BTRAKF2M 


PREPAR2M 


ASOLV2M 


ASEMBF2M 


-c 

-c 


PISS 


PPCG 


ILUCG 


FLOW.3 

] 

— 

BCPREP.3 

] 

H 

SPROP.3 

] 

H 

ASEMBF 3 

] 

- 1  BCF_3 

] 

H 

PISS 

] 

— 1 

PPCG 

] 

H 

ILUCG 

] 

—\ 

VELT 3 

] 

H 

BCTOP_3 

3.  Subroutines  concerning  the  computation  of  chemical/sediment  transport. 


TRANSP  1 

TRANSP.2 

TRANSP_3 

— - 

l 

ADVBCT.3 
btraktT 
asembtT 
EQGEMT  3 
BCT.3 
PISS 
PPCG 
ILUCG 
S0L_C3~ 

rhscmpT 


ADVBCT.2 

BTRAKT_2 

ASEMBT.2 

EQGENT_2 

BCT_2 

PISS 

PPCG 

ILUCG 

DEPERO 2 

SOL BS 

RHSCMP_2 

RESIDU.2 

SOL SS2 

SOL.C2 

ADVBCT_1 

BTRAKT_1 

ASEMBT.1 

EQGENT_1 

BCT_1 

PISS 

PPCG 

ILUCG 

DEPERO l 

SOL BS 

RHSCMPJ 

RESIDU_1 

SOL.SS1 

SOL BSJT 

C2JT 

SOL.SSJT 

S0L.C1 
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4.  Subroutines  concerning  backward  particle  tracking. 
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5.  Subroutines  concerning  particle  tracking  in  a  subelement. 


ELTRK.l 


ELTRK2M 


ELTRK.3H 


ELTRK.3H 


ADWKJ 

TRAK_1 


REPLAS.2 

VALBDL.2 

MML0C.2 


CKCNEL.2 


REPLAS.3 

BASE.31 

MML0C.3 


WRKARY.3 


REPLAS_3 
MML0C_3  ~ 
WRKARY.3 


0NPLAN.3 


II.2.  Subroutine  description 
MAIN 

This  main  program  serves  the  purpose  of  controlling  the  flow  path  of  desired  simulations.  It  calls 
to  Subroutines  FILES_3,  FELES_2,  and  FILES_1  to  read  in  necessary  data  to  undergo  numerical  simulations. 
It  calls  to  Subroutine  FLOW_3  to  compute  3-D  subsurface  flow,  Subroutine  TRANSP_3  to  compute  3-D 
subsurface  chemical  transport,  Subroutines  FLOW_2  or  FLOW2MOC  to  compute  2-D  overland  flow. 
Subroutine  TRANSP_2  to  calculate  2-D  overland  sediment  and  chemical  transprot.  Subroutine  FLOW_l  to 
compute  1-D  river/stream  flow,  and  Subroutine  TRANSP_1  to  calculate  1-D  river/stream  sediment  and 
chemical  transport.  It  also  calls  to  Subroutine  INF02S  to  evaluate  infiltration  from  overland  to  subsurface 
and  Subroutine  FLUX02C  to  estimate  both  water  and  material  flow  rates  from  overland  into  river/stream, 
and  vice  versa.  In  addition,  it  calls  to  needed  subroutines  to  print  or  store  numerical  results,  including  water 
depth,  stage,  discharge,  velocity,  and  concentrations,  at  desired  times. 

Subroutine  ADVBCFJL 

This  subroutine  is  to  implement  boundary  conditions  for  the  computation  in  the  Lagrangian  step  of 
solving  the  1-D  flow  equations.  In  this  subroutine,  boundary  conditions  with  either  water  depth  or  upstream 
inflow  specified  are  implemented  to  obtain  water  depth  at  associated  boundary  nodes.  In  addition,  Dirichlet- 
type  boundary  conditions  are  applied  to  junction-connected  river/stream  nodes. 

Subroutine  ADVBCF_2 

This  subroutine  is  to  implement  boundary  conditions  for  the  computation  in  the  Lagrangian  step  of 
solving  the  2-D  flow  equations.  In  this  subroutine,  boundary  conditions  with  either  water  depth  or  upstream 
inflow  specified  are  implemented  to  obtain  water  depth  at  associated  boundary  nodes.  At  the  river/stream- 
and  junction-related  nodes,  the  flow  direction  is  from  river/stream  or  junction  to  the  interior  of  overland,  the 
flux  is  estimated  and  the  corresponding  water  depth  is  calculated  accordingly. 

Subroutine  ADVBCF2M 

This  subroutine  is  to  implement  boundary  conditions  for  the  computation  in  the  Lagrangian  step  of 
solving  the  2-D  flow  equations  when  the  method  of  characteristics  is  applied.  In  this  subroutine,  boundary 
conditions  with  either  water  stage  or  upstream  inflow  specified  are  implemented  to  obtain  water  stage  or 
normal  flux,  respectively,  at  associated  boundary  nodes.  At  the  river/stream-  and  junction-related  nodes,  the 
flow  direction  is  from  river/stream  or  junction  to  the  interior  of  overland,  the  normal  flux  is  estimated  at  the 
corresponding  boundary  nodes. 

Subroutine  ADVBCT.l 

This  subroutine  is  to  implement  boundary  conditions  for  the  computation  in  the  Lagrangian  step  of 
solving  the  1-D  transport  equations  of  (1)  suspended  sediment,  (2)  dissolved  chemicals,  and  (3)  particulate 
chemicals  on  suspended  sediments.  Since  the  diffusive  flux  is  neglected  in  the  Lagrangian  Step,  only  are 
Dirichlet,  Cauchy,  and  variable  boundary  conditions  are  applied.  In  addition,  Dirichlet-type  boundary 
conditions  are  applied  to  junction-connected  river/stream  nodes. 

Subroutine  ADVBCT_2 

This  subroutine  is  to  implement  boundary  conditions  for  the  computation  in  the  Lagrangian  step  of 
solving  the  2-D  transport  equations  of  (1)  suspended  sediment,  (2)  dissolved  chemicals,  and  (3)  particulate 
chemicals  on  suspended  sediments.  Since  the  diffusive  flux  is  neglected  in  the  Lagrangian  Step,  only  are 
Dirichlet,  Cauchy,  and  variable  boundary  conditions  are  applied.  In  addition.  Variable-type  boundary 
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conditions  are  applied  to  river/stream-  and  junction-related  overland  nodes  if  flow  direction  is  determined 
from  river/stream/junction  to  overland. 

Subroutine  ADVBCT_3  .  . 

This  subroutine  is  to  implement  boundary  conditions  for  the  computation  in  the  Lagrangian  step  ot 
solving  the  3-D  transport  equations  of  dissolved  chemicals.  Since  the  diffusive  flux  is  neglected  in  the 
Lagrangian  Step,  only  are  Dirichlet,  Cauchy,  and  variable  boundary  conditions  are  applied.  In  addition. 
Variable-type  boundary  conditions  are  applied  to  overland-associated  subsurface  nodes  if  flow  direction  is 
determined  from  overland  to  subsurface. 


Subroutine  ADWK_1  .  . 

This  subroutine  is  to  determine  the  working  arrays  of  coordinates  (XW)  and  velocities  (VXW)  in 

the  element  being  considered  in  order  to  perform  the  1-D  “in-element”  particle  tracking. 


Subroutine  AD WK_2  .. 

This  subroutine  is  to  determine  the  working  arrays  of  coordinates  (XW),  velocities  (VXW), 
subelement  indices  (JEW),  subelement  boundary  index  (IBW),  and  subelement  connectivity  (NLRLW  and 
LRLW)  in  the  element  being  considered  in  order  to  perform  the  2-D  “in-element”  particle  tracking. 

Subroutine  ADWK_3  .  .  n 

This  subroutine  is  to  determine  the  working  arrays  of  coordinates  (XW),  velocities  (VXW), 
subelement  indices  (IEW),  subelement  boundary  index  (IBW),  and  subelement  connectivity  (NLRLW  and 
LRLW)  in  the  element  being  considered  in  order  to  perform  the  3-D  “in-element”  particle  tracking. 


Subroutine  ALGBY_2  .  _ 

This  subroutine  is  to  achieve  particle  tracking  along  the  2-D  unspecified  boundary.  Water  flow  is 
considered  parallel  to  the  boundary  on  the  specified  boundary.  This  subroutine  also  considers  the  first-order 
growth/decay  term  along  characteristics. 

Subroutine  ALGBYF2M  . 

This  subroutine  is  to  achieve  particle  tracking  along  the  2-D  unspecified  boundary.  Water  flow  is 
considered  parallel  to  the  boundary  on  the  specified  boundary.  It  is  used  only  when  the  method  of 
characteristics  is  employed  to  solve  the  2-D  flow  equation. 


Subroutine  ALGBY_3  . 

This  subroutine  is  to  achieve  particle  tracking  along  the  3-D  unspecified  boundary.  Water  flow  is 

considered  parallel  to  the  boundary  on  the  specified  boundary. 


Subroutine  AREA 

This  subroutine  is  to  compute  the  area  of  a  2-D  element,  either  quadrilateral  or  triangular. 


Subroutine  ASEMBF2M 

This  subroutine  is  to  compose  the  global  matrix  equation  to  adjust  2-D  velocity  in  the  last  part  of  the 
method  of  characteristic  approach  when  eddy  viscosity  is  taken  into  account. 


Subroutine  ASEMBF_3 

This  subroutine  is  to  compose  the  global  matrix  equation  to  compute  pressure  head  distribution  over 
the  domain  of  interest  at  the  time  being  considered. 
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Subroutine  ASEMBT_1 

This  subroutine  is  to  compute  global  coefficient  matrices  CMATRX1  and  GMATRX2  for  1-D 
transport  equations.  CMATRX1  is  a  mass  matrices  that  takes  into  account  the  total  time  derivative  term, 
while  CMATRX2  is  stiffness  matrices  that  considers  the  dispersion  term. 

Subroutine  ASEMBTJ2 

This  subroutine  is  to  compute  global  coefficient  matrices  CMATRX1  and  CMATRX2  for  2-D 
transport  equations.  CMATRX1  is  a  mass  matrices  that  takes  into  account  the  total  time  derivative  term, 
while  CMATRX2  is  stiffness  matrices  that  considers  the  dispersion  term. 

Subroutine  ASEMBT_3 

This  subroutine  is  to  compute  global  coefficient  matrices  CMATRXl  and  CMATRX2  for  3-D 
transport  equations.  CMATRXl  is  a  mass  matrices  that  takes  into  account  the  total  time  derivative  term, 
while  CMATRX2  is  stiffness  matrices  that  considers  the  dispersion  term. 

Subroutine  ASOLV2M 

This  subroutine  is  to  construct  and  solve  a  set  of  three  algebraic  equations  (Eqs.  (3.129)  through 
(3.131))  that  is  formed  by  using  the  method  of  characteristics  to  solve  the  dynamic  wave  model. 

Subroutine  BANSOL 

This  subroutine  is  to  solver  matrix  equations  with  a  direct  band  solver.  When  the  first  argument  is 
set  to  1,  the  subroutine  triangularizes  the  band  coefficient  matrices.  When  the  argument  is  set  to  2,  the 
subroutine  solves  for  the  solution  (back  substitution). 

Subroutine  BASE_21 

This  subroutine  is  to  compute  the  shape  functions  and  their  derivatives  at  a  point  located  in  a 
quadrilateral  element,  given  the  local  coordinates  at  the  point. 

Subroutine  BASE_22 

This  subroutine  is  to  compute  the  shape  functions  at  a  point  located  in  a  2-D  element  (either 
triangular  or  quadrilateral),  given  the  Cartesian  coordinates  both  at  the  point  and  element  nodes. 

Subroutine  BASE_31 

This  subroutine  is  to  compute  the  shape  at  a  point  located  in  a  hexahedral  element,  given  the  local 
coordinates  at  the  point. 

Subroutine  BASE_32 

This  subroutine  is  to  compute  the  shape  functions  and  their  derivatives  at  a  point  located  in  a  3-D 
element  (hexahedral,  triangular  prism,  or  quadrilateral),  given  the  Cartesian  coordinates  both  at  the  point  and 
element  nodes. 

Subroutine  BCDATF_3 

This  subroutine  is  to  transform  boundary  condition  arrays,  which  are  used  to  implementing  3-D 
subsurface  flow  boundary  conditions,  from  containing  global  nodes  to  containing  boundary  nodes. 

Subroutine  BCDATT_3 

This  subroutine  is  to  transform  boundary  condition  arrays,  which  are  used  to  implementing  3-D 
subsurface  transport  boundary  conditions,  from  containing  global  nodes  to  containing  boundary  nodes. 
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This  subroutine  is  to  implement  Dirichlet,  Cauchy,  Neumann,  Variable,  and  River  boundary 
conditions  in  computing  3-D  subsurface  flow.  The  detailed  description  for  this  subroutine  can  be  found 
elsewhere  [Yeh  et  al,  1997]. 

This  subroutine  is  to  prepare  boundary  conditions  for  the  boundary  that  allows  water  to  flow  through 
it  but  does  not  have  the  flow  direction  known  as  a  priori  (i.e.,  the  so-called  Variable  boudanry).  e  etai  e 
description  for  this  subroutine  can  be  found  elsewhere  [Yeh  et  al,  1997]. 

Subroutine  BCTOP_3  ...  . 

This  subroutine  is  to  determine  which  type  of  boundary  condition,  flux  type  or  Dinchlet  type,  is  to 

be  applied  to  the  surface/subsurface  interface  boundary.  The  criteria  involved  in  this  subroutine  for 
detennination  are  similar  to  those  employed  in  Subroutine  BCPREP.3.  The  detailed  description  for  this 
subroutine  can  be  found  elsewhere  [Yeh  et  al,  1997]. 

This  subroutine  is  to  implement  boundary  conditions,  including  Dinchlet,  Cauchy,  Neumann, 
conventional  variable,  and  junction-related  variable  types,  for  1-D  river/stream  transport.  Ail  boundary 
conditions,  exceptfor  the  junction-related  variable  type,  are  specified  at  boundary  nodes  (or  reach  ends)  with 
time-dependent  profiles.  For  junction-connected  nodes,  junction-related  variable  boundary  conditions  are 

applied. 

U  r°Ui  subroutine  is  to  implement  boundary  conditions,  including  Dirichlet,  Cauchy,  Neumann, 
conventional  variable,  and  river/stream-related  or  junction-related  variable  types,  for  2-D  overland  transport. 
Dirichlet  boundary  conditions  are  specified  at  boundary  nodes,  while  the  other  types  of  boundary  conditions 
are  categorized  as  flux-type  boundary  conditions  and  are  specified  on  boundary  sides.  Dinchlet  Cauchy, 
Neumann,  and  conventional  variable  boundary  conditions  are  prescnbed  with  time-dependentprofiles,  while 
river/stream-  or  junction-related  variable  boundary  conditions  are  applied  to  their  associated  boundary  sides. 

Subroutine  BCT_3  XT 

This  subroutine  is  to  implement  boundary  conditions,  including  Dinchlet,  Cauchy,  Neumann, 

conventional  variable,  and  overland-associated  variable  types,  for  3-D  subsurface  transport.  Dinchlet 
boundary  conditions  are  specified  at  boundary  nodes,  while  the  other  types  of  boundary  conditions  are 
categorized  as  flux-type  boundary  conditions  and  are  specified  on  boundary  sides.  Dinchlet,  Cauchy, 
Neumann,  and  conventional  variable  boundary  conditions  are  prescribed  with  time-dependent  profiles,  while 
overland-associated  variable  boundary  conditions  are  applied  to  their  associated  boundary  sides. 


This  subroutine  is  to  locate  the  four  global  nodes  for  returning  information  to  subroutine  BTRAKT_3 
when  the  particle  has  encountered  the  boundary  or  working  element  (i.e.,  the  working  element  side). 

Subroutine  BNDRY_3 

This  subroutine  is  to  determine  the  location  of  the  target  point  in  a  particle  tracking  along  a 
unspecified  boundary  side. 


Subroutine  BSHEAR.l 

This  subroutine  is  to  achieve  the  calculation  of  bottom  shear  stress  at  all  river/stream  nodes. 

Subroutine  BSHEAR_2 

This  subroutine  is  to  achieve  the  calculation  of  bottom  shear  stress  at  all  overland  nodes. 

Subroutine  BTRAKF_1 

This  subroutine  is  to  implement  backward  particle  tracking  to  obtain  the  water  depth  at  all  1  -D  global 
nodes.  Since  a  first-order  approach  is  used  for  both  kinematic  and  diffusion  models  and  all  source/sink  rate 
terms  can  be  expressed  a  linear  function  of  water  depth,  we  thus  take  into  account  the  first-order 
decay/growth  rate  along  the  characteristics  when  we  implement  backward  particle  tracking.  As  for  the 
zeroth-order  source/sink  rate,  we  simply  multiply  this  rate  by  the  time-step  size  being  considered  and  add 
the  product  to  the  outcome  of  backward  particle  tracking. 

Subroutine  BTRAKF_2 

This  subroutine  is  to  implement  backward  particle  tracking  along  three  characteristics  to  obtain  the 
Lagrangian  water  depth  and  veloctiy  at  all  2-D  global  nodes  when  the  method  of  characteristics  is  used  to 
solve  2-D  flow  equations.  The  spatial  reachout  approach  is  currently  implemented  in  this  subroutine. 

Subroutine  BTRAKF2M 

This  subroutine  is  to  implement  backward  particle  tracking  to  obtain  the  water  depth  at  all  2-D  global 
nodes.  Since  a  first-order  approach  is  used  for  both  kinematic  and  diffusion  models  and  all  source/sink  rate 
terms  can  be  expressed  a  linear  function  of  water  depth,  we  thus  take  into  account  the  first-order 
decay/growth  rate  along  the  characteristics  when  we  implement  backward  particle  tracking.  As  for  the 
zeroth-order  source/sink  rate,  we  simply  multiply  this  rate  by  the  time-step  size  being  considered  and  add 
the  product  to  the  outcome  of  backward  particle  tracking. 

Subroutine  BTRAKT _1 

This  subroutine  is  to  implement  backward  particle  tracking  to  obtain  the  Lagrangian  values  of 
concentrations  of  (1)  dissolved  chemicals,  (2)  suspended  sediments,  and  (3)  particulate  chemicals  on 
suspended  sediments  at  all  1-D  global  nodes. 

Subroutine  BTRAKT_2 

This  subroutine  is  to  implement  backward  particle  tracking  to  obtain  the  Lagrangian  values  of 
concentrations  of  (1)  dissolved  chemicals,  (2)  suspended  sediments,  and  (3)  particulate  chemicals  on 
suspended  sediments  at  all  2-D  global  nodes. 

Subroutine  BTRAKT_3 

This  subroutine  is  to  implement  backward  particle  tracking  to  obtain  the  Lagrangian  values  of 
concentrations  of  dissolved  chemicals  at  all  3-D  global  nodes. 

Subroutine  CFACE_3 

This  subroutine  is  to  trarisform  the  3-D  element  face  ID  generated  from  GMS  to  the  convention  used 
in  the  computer  code. 

Subroutine  CHNGSN 

This  subroutine  is  to  change  sign  of  the  velocities  at  point  P  (the  starting  location),  point  Q  (the 
ending  location),  and  working  subelement  nodes  in  the  process  of  2-D  or  3-D  “in-element”  particle  tracking. 
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Subroutine  CKBDY_3 

This  subroutine  is  to  determine  the  unspecified  boundary  sides  that  are  connected  to  global  nodes. 
The  information  is  saved  in  two  arrays  (IBDY  and  NBDYB)  and  is  used  for  implementing  particle  tracking 
along  the  unspecified  boundary. 

Subroutine  CKCNEL_2 

This  subroutine  is  to  determine  the  element  that  connects  to  a  specified  element  through  the  element 
side  with  the  Nl-th  and  N2-th  global  nodes  serving  as  the  two  end  nodes  of  the  2-D  side. 

Subroutine  CKCNEL_3 

This  subroutine  is  to  determine  the  element  that  connects  to  a  specified  element  through  the  element 
side  with  the  Nl-th  and  N2-th  global  nodes  serving  as  the  two  end  nodes  of  the  3-D  side. 

Subroutine  CKCOIN_2 

This  subroutine  is  to  determine  whether  or  not  a  specific  node  coincides  with  the  Nl-th  global  node 
or  the  N2-th  global  node. 

Subroutine  CKCOIN_3 

This  subroutine  is  to  determine  whether  or  not  a  specific  node  coincides  with  the  Nl-th  global  node 
,  the  N2-th  global  node,  the  N3-th  global  node,  or  the  N4-th  global  node. 

Subroutine  CKSIDE_3 

This  subroutine  is  to  determine  whether  or  not  a  specific  node  is  on  the  3-D  element  side  that  has 
global  nodes  Nl,  N2,  N3,  and  N4  as  its  side  nodes. 

Subroutine  COMAP 

This  subroutine  is  to  (1)  relate  1-D  river/stream  nodes  to  2-D  overland  nodes,  (2)  relate  2-D  overland 
nodes  to  3-D  subsurface  nodes,  and  (3)  relate  2-D  overland  elements  to  3-D  subsurface  elements.  Those 
overland  nodes  which  correspond  to  river/stream  nodes  will  not  be  taken  into  account  in  2-D  overland 
simulations. 

Subroutine  CRACKD 

This  subroutine  is  to  read  real  numbers  in  order  from  a  line  data  record. 

Subroutine  CRACKI 

This  subroutine  is  to  read  integer  numbers  in  order  from  a  line  data  record. 

Subroutine  C2JT 

This  subroutine  is  to  compute  the  flow  rate  of  (1)  water  (when  ID  =1),  (2)  dissolved  chemicals 
(when  ID  =  2),  (3)  particulate  chemicals  on  suspended  sediments  (when  ID  =  3),  and  (4)  particulate 
chemicals  on  bed  sediments  (when  ID  =  4)  from  junction-connected  river/streams  to  a  specified  junction. 

Subroutine  DEPERO_l 

This  subroutine  is  to  compute  the  deposition  and  erosion  rates  either  at  a  river/stream  node  (when 
NP  is  not  zero  and  J  is  zero)  or  at  a  junction  (when  NP  equals  zero  and  J  is  not  equal  to  zero).  Both  cohesive 
and  non-cohesive  cases  are  taken  into  account.  The  following  equations  are  used  to  achieve  the  computation 
at  a  river/stream  node. 

(1)  For  cohesive  sediments: 
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where  V,,,  is  the  settling  velocity  of  the  n-th  size  fraction  sediment  [L/T];  Tb  is  the  bottom  shear  stress  or  the 
bottom  friction  stress  [M/L/T2];  xcDn  is  the  critical  shear  stress  for  the  deposition  of  the  n-th  size  fraction 
sediment  [M/L/T2] ;  x,^  is  the  critical  shear  stress  for  the  erosion  of  the  n-th  size  fraction  sediment  [M/L/T2] ; 
En  is  the  erodibility  of  the  n-th  size  fraction  sediment  [M/L2].  In  the  computer  code,  V^,  xeDn,  x^,  and  En 
are  input  parameters,  while  xb  is  confuted  in  the  flow  module.  The  above  two  equations  can  be  found  from 
“CHNTRN:  A  River/stream  Transport  Model  for  Simulating  Sediment  and  Chemical  Distribution  in  a 
Stream/River  Network”  by  Yeh  (1983),  ORNL-5882  Report,  Eq.  (29)  on  page  12. 

(2)  For  non-cohesive  sediments: 
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where  is  the  actual  load  rate  of  the  n-th  size  fraction  sediment  per  unit  width  at  a  upstream  location 
[M/L/T];  Ga,  is  the  maximum  load  rate  (capacity)  of  the  n-th  size  fraction  sediment  per  unit  width  at  a 
downstream  location  [M/L/T];  AL  is  the  distance  between  the  upstream  and  the  downstream  locations.  Eqs. 
The  above  two  equations  can  be  found  from  “CHNTRN:  A  River/stream  Transport  Model  for  Simulating 
Sediment  and  Chemical  Distribution  in  a  Stream/River  Network”  by  Yeh  (1983),  ORNL-5882  Report,  Eq. 
(30)  on  page  12.  In  the  computer  code,  AL  can  be  determined  based  on  the  coordinates,  while  GsAn  and  G^ 
are  computed  based  on  the  following  equations. 

GsAn=Sn*U*r  (H.5) 
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where  p  is  the  fluid  density  [M/L3];  is  the  density  of  the  n-th  size  fraction  sediment  [M/L3];  u  is 
river/stream  flow  velocity  [L/T];  r  is  hydraulic  radius  [L];  S  the  friction  slope,  dn  is  the  median  diameter  of 
the  n-th  size  fraction  sediment  particle  [L];  g  is  gravity  [L/T2];  xOT  is  the  critical  bottom  shear  stress  of  the 
n-th  size  fraction  sediment  at  which  sediment  movement  begins  [M/L/T2].  Among  these  parameters,  p,  pB, 
d,,,  and  x^  are  input  by  users,  while  u,  r,  and  S  are  estimated  in  the  flow  module.  The  above  equation  is  from 
“Hydraulics  of  Sediment  Transport”  by  Walter  Hans  Graf  (1984),  Water  Resources  Publication,  Eq.  (7.14) 
on  page  128. 


To  estimate  the  deposition  and  erosion  rates  at  a  junction,  the  following  weighted-average  equations 
are  employed. 
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where  Dn(J)  and  R„(j)  are  the  deposition  and  erosion  rate  at  the  J-th  junction;  Uj,  P;,  D^,  are  the  velocity, 
wetted  perimeter,  deposition  rate,  and  erosion  rate  at  the  river/stream  node  that  serves  as  the  i-th  junction- 
connected  node  to  the  J-th  junction;  NJRTH(J)  is  number  of  river/stream  reaches  that  are  connected  to  the 
J-th  junction. 


Subroutine  DEPERO_2 

This  subroutine  is  to  compute  the  deposition  and  erosion  rates  at  an  overland  node.  The  equations 
described  in  Subroutine  DEPERO_l  are  also  used  here. 


Subroutine  DGELG 

This  subroutine  is  to  solve  matrix  equations  by  a  direction  solver  incorporated  with  full-pivoting. 


Subroutine  DISPC_1 

This  subroutine  is  to  compute  dispersion  coefficients  for  1-D  transport  simulations.  The  coefficient 
is  evaluated  at  every  quadrature  node  of  elements. 

Subroutine  DISPC_2 

This  subroutine  is  to  compute  dispersion  coefficients  for  2-D  transport  simulations.  The  coefficient 
is  evaluated  at  every  quadrature  node  of  elements. 

Subroutine  DISPC_3 

This  subroutine  is  to  compute  dispersion  coefficients  for  3-D  transport  simulations.  The  coefficient 
is  evaluated  at  every  quadrature  node  of  elements. 

Function  DOTPRD 

This  function  is  to  compute  the  inner  product  of  two  given  vectors. 

Subroutine  ELENOD_2 

This  subroutine  is  to  determine  the  number  of  element  nodes  for  a  specified  2-D  element. 

Subroutine  ELENOD_3 

This  subroutine  is  to  determine  the  number  of  element  nodes  and  the  element  shape  for  a  specified 
3-D  element. 

Subroutine  ELTRK_1 


AppU-12 


This  subroutine  is  to  implement  the  1-D  “in-element”  particle  tracking  for  a  particle  with  its  starting 
location  specified.  During  the  tracking  process,  many  elements  can  be  passed  through.  The  first-order 
growth/decay  term  is  also  taken  into  account  in  the  tracking. 

Subroutine  ELTRK_2 

This  subroutine  is  to  implement  the  2-D  “in-element”  particle  tracking  in  a  specified  element.  The 
first-order  growth/decay  term  is  also  taken  into  account  in  the  tracking. 

Subroutine  ELTRK2M 

This  subroutine  is  to  implement  the  2-D  “in-element”  particle  tracking  in  a  specified  element.  It  is 
used  only  when  the  method  of  characteristics  is  used  to  solve  the  2-D  flow  equation. 

Subroutine  ELTRK_3H 

This  subroutine  is  to  implement  the  3-D  “in-element”  particle  tracking  in  a  specified  hexahedral 
element. 

Subroutine  ELTRK_3P 

This  subroutine  is  to  implement  the  3-D  “in-element”  particle  tracking  in  a  specified  triangular  prism 
element. 

Subroutine  ELTRK_3T 

This  subroutine  is  to  implement  the  3-D  “in-element”  particle  tracking  in  a  specified  texahedral 
element. 

Subroutine  EQGENT_1 

This  subroutine  is  to  generate  matrix  equations  for  1-D  transport  simulations.  When  IDC  =  0,  it  is 
for  the  transport  of  the  IDS-th  suspended  sediment.  When  IDS  =  0,  it  is  for  the  transport  of  the  IDC-th 
dissolved  chemical.  When  neither  IDC  nor  IDs  equals  zero,  it  is  for  the  IDC-th  particulate  chemical  on  the 
IDS-th  suspended  sediment. 

Subroutine  EQGENT_2 

This  subroutine  is  to  generate  matrix  equations  for  2-D  transport  simulations.  When  IDC  =  0,  it  is 
for  the  transport  of  the  IDS-th  suspended  sediment.  When  IDS  =  0,  it  is  for  the  transport  of  the  IDC-th 
dissolved  chemical.  When  neither  IDC  nor  IDs  equals  zero,  it  is  for  the  IDC-th  particulate  chemical  on  the 
IDS-th  suspended  sediment. 

Subroutine  EQGENT.3 

This  subroutine  is  to  generate  matrix  equations  for  3-D  transport  simulations.  Only  are  the  dissolved 
chemicals  involved. 

Subroutine  FACE02C 

This  subroutine  is  to  determine  those  overland  boundary  sides  which  are  either  river/stream-related 
or  junction-related. 

Subroutine  FACE23B 

This  subroutine  is  to  prepare  arrays  for  describing  the  surface/subsurface  interface  boundary,  based 
on  the  mapping  information  from  the  input  data. 
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Function  FCOS_2 

This  is  to  determine  the  direction  of  the  outer  product  of  two  2-D  vectors. 

Function  FCOS_3 

This  is  to  determine  the  direction  of  the  inner  product  of  two  3-D  vectors. 

Subroutine  FILES_1 

This  subroutine  is  to  read  in  information  in  order  to  perform  1-D  river/stream  simulations.  The 
information  includes  (1)  geometry  data,  (2)  flow  simulation  data,  and  (3)  transport  simulation  data. 

Subroutine  FILES_2 

This  subroutine  is  to  read  in  information  in  order  to  perform  2-D  overland  simulations.  The 
information  includes  (1)  geometry  data,  (2)  flow  simulation  data,  (3)  transport  simulation  data,  and  (4)  l-D/2- 
D  and  2-D/3-D  interface  data. 

Subroutine  FILES_3 

This  subroutine  is  to  read  in  information  in  order  to  perform  3-D  subsurface  simulations.  The 
information  includes  (1)  geometry  data,  (2)  flow  simulation  data,  and  (3)  transport  simulation  data. 

Subroutine  FIXCKF_2 

This  subroutine  is  to  handle  the  case  in  the  particle  tracking  of  2-D  water  flow  when  a  particle 
encounters  the  boundary.  If  this  boundary  is  a  specified  (flow-through)  boundary,  the  current  particle 
tracking  stops  here  and  interpolation  is  employed  to  compute  the  Lagrangian  value.  If  this  boundary  is 
unspecified  (closed),  on  the  other  hand,  the  flow  direction  is  parallel  to  the  boundary  and  particle  tracking 
along  the  boundary  proceeds  until  either  the  available  tracking  time  is  completely  consumed  or  a  specified 
boundary  is  reached.  The  first-order  growth/decay  term  is  also  taken  into  account  in  the  tracking. 

Subroutine  FIXCKF2M 

This  subroutine  is  to  handle  the  case  in  the  particle  tracking  of  2-D  water  flow  when  a  particle 
encounters  the  boundary.  If  this  boundary  is  a  specified  (flow-through)  boundary,  the  current  particle 
tracking  stops  here  and  interpolation  is  employed  to  compute  the  Lagrangian  value.  If  this  boundary  is 
unspecified  (closed),  on  the  other  hand,  the  flow  direction  is  parallel  to  the  boundary  and  particle  tracking 
along  the  boundary  proceeds  until  either  the  available  tracking  time  is  completely  consumed  or  a  specified 
boundary  is  reached.  It  is  used  only  when  the  method  of  characteristics  is  employed  to  solve  the  2-D  flow 
equation. 

Subroutine  FIXCKT_2 

This  subroutine  is  to  handle  the  case  in  the  particle  tracking  of  2-D  chemical  transport  when  a 
particle  encounters  the  boundary.  If  this  boundary  is  a  specified  (flow-through)  boundary,  the  current 
particle  tracking  stops  here  and  interpolation  is  employed  to  compute  the  Lagrangian  value.  If  this  boundary 
is  unspecified  (closed),  on  the  other  hand,  the  flow  direction  is  parallel  to  the  boundary  and  particle  tracking 
along  the  boundary  proceeds  until  either  the  available  tracking  time  is  completely  consumed  or  a  specified 
boundary  is  reached. 

Subroutine  FIXCKT_3 

This  subroutine  is  to  handle  the  case  in  the  particle  tracking  of  3-D  chemical  transport  when  a 
particle  encounters  the  boundary.  If  this  boundary  is  a  specified  (flow-through)  boundary,  the  current 
particle  tracking  stops  here  and  interpolation  is  employed  to  compute  the  Lagrangian  value.  If  this  boundary 
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is  unspecified  (impermeable),  on  the  other  hand,  the  flow  direction  is  parallel  to  the  boundary  and  particle 
tracking  along  the  boundary  proceeds  until  either  the  available  tracking  time  is  completely  consumed  or  a 
specified  boundary  is  reached. 


Function  FKAPA_2 

This  function  is  to  compute  the  bottom  friction  coefficient,  k,  as  defined  as  follows. 

gn|V(h+Z0)|1/2[l  +(VZo)2|2/3 
h2* 


(D.9) 


Subroutine  FKK1_1 

This  subroutine  is  to  compute  the  flow  velocity  at  global  nodes  for  either  the  kinematic  model  or  the 
diffusion  model  of  1-D  river/stream  flow. 

Subroutine  FKK1_2 

This  subroutine  is  to  compute  the  flow  velocity  at  global  nodes  for  either  the  kinematic  model  or  the 
diffusion  model  of  2-D  overland  flow. 

Subroutine  FKK2_1 

This  subroutine  is  to  compute  the  source/sink  term  at  a  global  node  due  to  non-uniform  bed  slope 
or  potential  slope  for  the  kinematic  model  or  the  diffusion  model,  respectively,  of  1-D  river/stream  flow. 

Subroutine  FKK2_2 

This  subroutine  is  to  compute  the  source/sink  term  at  a  global  node  due  to  non-uniform  bed  slope 
or  potential  slope  for  the  kinematic  model  or  the  diffusion  model,  respectively,  of  2-D  overland  flow. 

Subroutine  FLOW_l 

This  subroutine  serves  as  the  control  panel  of  computing  1-D  river/stream  flow  by  using  the 
Lagrangian  approach  to  solve  the  diffusion  model.  The  Picard  method  is  used  to  deal  with  nonlinearity. 
During  each  nonlinear  iteration,  the  working  velocity  is  first  estimated  based  on  the  working  water  depth  with 
Eq.  (2.3).  This  working  velocity  is  then  used  to  achieve  backward  particle  tracking  in  the  Lagrangian 
approach  to  obtain  the  updated  water  depth.  Convergence  is  determined  by  checking  the  maximum  relative 
error  of  water  depth.  Relaxation  technique  is  applied  to  update  the  working  water  depth  for  the  next  iteration 
if  convergence  has  not  been  reached.  When  junctions  exist,  water  budget  is  employed  to  determine  the  water 
depth  at  junctions.  The  flow  rates  of  water  coming  from  or  going  into  the  junction-connected  reaches  are 
calculated  based  on  the  working  velocity  and  cross-sectional  areas  at  junction-reach  interfacial  nodes  (e.g., 
Nodes  10, 13,  and  32  in  Figure  4.4). 

Subroutine  FLOW_2 

This  subroutine  serves  as  the  control  panel  of  computing  2-D  overland  flow  by  using  the  Lagrangian 
approach  to  solve  the  diffusion  model.  The  Picard  method  is  used  to  deal  with  nonlinearity.  During  each 
nonlinear  iteration,  the  working  velocity  is  first  estimated  based  on  the  working  water  depth  with  Eqs.  (2. 12) 
and  (2.13).  This  working  velocity  is  then  used  to  achieve  backward  particle  tracking  in  the  Lagrangian 
approach  to  obtain  the  updated  water  depth.  Convergence  is  determined  by  checking  the  maximum  relative 
error  or  water  depth.  Relaxation  technique  is  applied  to  update  the  working  water  depth  for  the  next  iteration 
if  convergence  has  not  been  reached. 
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Subroutine  FLO W2MOC  , 

This  subroutine  serves  as  the  control  panel  of  computing  2-D  overland  flow  by  using  the  method  of 
characteristics  to  solve  the  dynamic  model.  The  Picard  method  is  used  to  deal  with  nonlinearity.  During 
each  nonlinear  iteration.  The  characteristic  equation  (Eq.  (3.85))  is  solved  first  by  the  backward  particle 
tracking  along  three  characteristics.  After  H*,  u#,  and  v#  are  determined,  we  compute  H,  u,  and  v  by  solving 
Eqs.  (3.151)  through  (3.153).  Convergence  is  determined  by  checking  the  maximum  relative  error  of  H,  u, 
and  v.  Relaxation  technique  is  applied  to  update  the  working  water  stage  and  velocity  for  the  next  iteration 
if  convergence  has  not  been  reached. 

Subroutine  FLO  W_3  w 

This  subroutine  serves  as  the  control  panel  of  computing  3-D  subsurface  flow  by  usmg  the  Gelarkm 
finite  element  method  solve  the  Richard’s  equation.  The  Picard  method  is  used  to  deal  with  nonlinearity. 
During  each  nonlinear  iteration,  pressure  head  is  computed  and  moisture  content,  water  capacity,  and 
hydraulic  conductivity  are  updated  accordingly.  Convergence  is  determined  by  checking  the  maximum 
absolute  error.  The  detailed  description  for  this  subroutine  can  be  found  elsewhere  [Yeh  et  al,  1997]. 

Subroutine  FLUX02C  , 

This  subroutine  is  to  compute  flow  rate  of  water,  dissolved  chemicals,  suspended  sediments,  and 

particulate  chemicals  on  suspended  sediments  from  overland  to  both  river/stream  nodes  and  river/stream 
junctions.  When  the  outward  normal  velocity  is  positive  at  a  river/stream-  or  junction-related  overland 
boundary  node,  there  is  water  flowing  from  overland  to  the  associated  river/stream  node  or  junction.  If  the 
outward  normal  velocity  is  negative,  two  cases  are  taken  into  account:  when  the  associated 
river/stream/junction  water  stage  is  higher  than  the  bottom  elevation  of  this  overland  boundary  node,  there 
is  water  flowing  from  river/stream/junction  to  overland:  otherwise,  there  is  no  water  passing  through  the  1D- 

2D  interface. 

Subroutine  FTAUB_1 

This  subroutine  is  to  calculate  bottom  shear  stress  at  a  river/stream  node.  The  bottom  shear  stress 
is  computed  according  to  the  following  equation. 

tb  =  upgn|V(h+Z0)]1/2[l  +(VZ0)2]2/3  r1/3  (11.10) 

where  tb  is  bottom  shear  stress;  u  is  river/stream  velocity;  p  is  water  density;  g  is  gravity,  n  is  Manning  s  n, 
h  is  water  depth;  Z ^  is  bottom  elevation;  and  r  is  hydraulic  radius. 

Subroutine  FTAUB_2 

This  subroutine  is  to  calculate  bottom  shear  stress  at  an  overland  node.  The  bottom  shear  stress  is 
computed  according  to  the  following  equations. 

tb  =  upgn|V(h  +Z0)|1/2[l  +(VZ0)2p3h1/3  (HU) 

tb  =  vpgn|V(h+Z0)|1/2[l  +(VZ0)2f3h1/3  (H.12) 

where  xxb  and  xyb  are  bottom  shear  stress  in  x-  and  y-directions,  respectively;  u  and  v  are  velocity  components 
in  x-  and  y-directions,  respectively;  p  is  water  density;  g  is  gravity;  n  is  Manning’s  n;  h  is  water  depth;  Zo 
is  bottom  elevation. 

Subroutine  GAUPNT_2 
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This  subroutine  is  to  compute  shape  functions  and  their  derivatives  at  quadrature  nodes. 

Subroutine  GEOGRAD 

This  subroutine  is  to  compute  the  derivatives  of  hydraulic  radius  and  average  river/stream  width  with 
respect  to  distance  and  water  depth  in  1-D  river/stream  flow  simulations. 

Subroutine  GEOM1DC 

This  subroutine  is  to  determine  the  river/stream-associated  overland  elements  that  are  not  to  be  taken 
into  account  in  2-D  overland  simulations. 

Subroutine  GEOM_l 

This  subroutine  is  to  read  in  1-D  river/stream  geometry,  including  coordinates  and  element  indices. 

Subroutine  GEOM_2 

This  subroutine  is  to  read  in  2-D  overland  geometry,  including  coordinates  and  element  indices. 

Subroutine  GEOM_3 

This  subroutine  is  to  read  in  3-D  subsurface  geometry,  including  coordinates  and  element  indices. 

Subroutine  GEOPREP 

This  subroutine  is  to  prepare  the  profile  of  describing  the  derivatives  of  both  hydraulic  radius  and 
average  river/stream  width  with  respect  to  water  depth,  based  on  the  prescribed  profiles  of  river/stream 
geometry. 

Subroutine  GRAD_1 

This  subroutine  is  to  compute  the  spatial  derivatives  of  water  depth,  stage,  flow  velocity,  average 
river/stream  width,  and  Manning’s  n  as  desired  in  1-D  river/stream  simulations.  In  addition,  the  second 
spatial  derivatives  of  water  depth  and  stage  are  calculated  as  needed. 

Subroutine  GRAD_2 

This  subroutine  is  to  compute  the  spatial  derivatives  of  water  depth,  stage,  flow  velocity,  and 
Manning’s  n  as  desired  in  2-D  overland  simulations.  In  addition,  the  second  spatial  derivatives  of  water 
depth  and  stage  are  calculated  as  needed. 

Subroutine  IBWCHK_2 

This  subroutine  is  to  determine  the  two  global  nodes  that  serve  as  the  two  end  node  of  an  element 
side.  This  element  side  is  the  side  that  the  particle  has  encountered  when  it  passes  through  the  element  being 
considered. 

Subroutine  IDFBS 

This  subroutine  is  to  relate  flux-type  boundary  sides  with  global  boundary  sides.  The  relationship 
is  stored  in  two  arrays:  one  for  flow  simulations  and  the  other  for  transport  simulations. 

Subroutine  ILUCG 

This  subroutine  is  to  solve  the  linearized  matrix  equation  that  is  sparse  asymmetric  with  the 
preconditioned  conjugate  gradient  method  using  the  incomplete  Cholesky  decomposition  as  a  preconditioner. 

Subroutine  INF02S 
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This  subroutine  is  to  compute  infiltration  flux  (L3/T)  at  all  overland  nodes.  Based  on  the  concept 
of  continuity  of  flux,  the  following  equation  is  used  to  compute  the  flux. 


<J>;  =  f-(n-V) 


1  + 

1  + 

[s] 

N 

J  M 

,  5y  , 

dR 


(II.13) 


where  n  and  V  are  the  outward  unit  normal  vector  and  Darcy  velocity  (specific  discharge),  respectively,  at 
the  3-D  subsurface  boundary  node  that  is  corresponding  to  the  2-D  overland  node  being  considered;  dZJdx 
and  dZ.Jdy  are  the  derivatives  of  elevation  in  the  x-  and  the  y-directions,  respectively,  at  the  2-D  overland 

node. 


Subroutine  INTRPF_2 

This  subroutine  is  to  determine  the  Lagrangian  water  depth  by  interpolation  after  backward  particle 
tracking  in  solving  flow  governing  equations  when  the  diffusion  wave  model  is  taken  into  account. 

Subroutine  INTRPF2M  ....  . 

This  subroutine  is  to  determine  the  Lagrangian  characteristic  quantities  by  interpolation  after 
backward  particle  tracking  in  solving  flow  governing  equations  when  the  method  of  characteristics  is  used 
to  deal  with  the  dynamic  wave  model. 

Subroutine  INTRPT_2 

This  subroutine  is  to  determine  the  Lagrangian  chemical  and  suspended  sediment  concentrations  by 
interpolation  after  backward  particle  tracking  in  the  Lagrangian  step  of  solving  2-D  transport  governing 
equations. 

Subroutine  INTRPT_3 

This  subroutine  is  to  determine  the  Lagrangian  chemical  concentrations  by  interpolation  after 
backward  particle  tracking  in  the  Lagrangian  step  of  solving  3-D  transport  governing  equations. 

Subroutine  JACOBI_l  . 

This  subroutine  is  to  compute  the  Jacobian  for  the  chemical  system  at  the  NP-th  node  (when  NP  is 
not  equal  to  zero  and  J  equals  zero)  or  the  J-th  junction  (when  NP  equals  zero  and  J  is  not  equal  to  zero). 
The  Jacobian  elements  are  defined  as  follows. 


For  the  case  at  the  NP-th  node: 
(1)  For  dissolved  chemicals: 
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(2)  For  particulate  chemicals  on  suspended  sediments: 
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(3)  For  particulate  chemicals  on  bed  sediments: 
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It  is  noted  that  if  SS,  R,  Rl,  and  R2  are  negative  (i.e.,  sinks),  they  should  not  appear  in  Eqs.  (11.14) 
and  (H.18).  Likewise,  if  I  is  positive  (i.e,  sink),  it  must  not  appear  in  the  two  equations. 


For  the  case  at  the  J-th  junction: 
(1)  For  dissolved  chemicals: 


AppH-19 


6RESC 


w/n\N+i 


a(c,  (j)> 

[n, 


L.  =  8ilV(J)+8ilAt 


Sn(J)V(J)^+E  Mn(J)A(J)k^f 

n=l 


Ns 

I 

n=l 


At 


Nc 


m.23) 


f\  CV(J)b1-(Cr(J))b"'‘  II  (Cj*(J))"'-E^V(J)a^(C1-(J)),“'‘  n  (CjW(W 

m=l  m=1  i=lj’'1 

ie[l,Nc] 


3RESC- 


a(c^(j))N+1 

3RESC 


1—  =  -8a AtCs^DVCJ)  ne[l^s],  ie[l,Nc], 


a(cIJb(J))Ntl 

(2)  For  particulate  chemicals  on  suspended  sediments 
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(3)  For  particulate  chemicals  on  bed  sediments: 
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Subroutine  JACOBI_2 

This  subroutine  is  to  compute  the  Jacobian  for  the  chemical  system  at  the  NP-th  node.  The  Jacobian 
elements  are  defined  as  follows. 


(1)  For  dissolved  chemicals: 
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(2)  For  particulate  chemicals  on  suspended  sediments: 
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It  is  noted  that  if  SS,  and  R  are  negative  (i.e.,  sinks),  they  should  not  appear  in  Eqs.  (11.32)  and 
(R.36).  Likewise,  if  I  is  positive  (i.e,  sink),  it  must  not  appear  in  the  two  equations. 

Subroutine  JACOBI_3  . 

This  subroutine  is  to  compute  the  Jacobian  for  the  chemical  system  at  the  NP-th  node.  The  Jacobian 

elements  are  defined  as  follows. 


(1)  For  dissolved  chemicals: 
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(2)  For  adsorbing  sites: 
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(3)  For  adsorbed  chemicals: 
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It  is  noted  that  if  q  is  negative  (i.e.,  sink),  it  should  not  appear  in  Eq.  (11.41). 
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Subroutine  JUNCTION 

This  subroutine  is  to  update  water  depths  (stages)  at  junctions  based  on  the  concept  of  water  budget. 

Subroutine  KXKY.2M 

This  subroutine  is  to  determine  characteristic  directions  at  a  2-D  global  node  for  overland  flow 
simulations,  based  on  the  velocity,  the  spatial  velocity  derivatives,  and  the  spatial  stage  derivatives  at  the 
node.  This  subroutine  is  needed  only  when  the  method  of  characteristics  is  employed  to  solve  the  2-D  flow 
equation. 


Subroutine  KXKYNP2M 

This  subroutine  is  to  determine  characteristic  directions  at  all  2-D  global  nodes  for  overland  flow 
simulations.  This  subroutine  is  needed  only  when  the  method  of  characteristics  is  employed  to  solve  the  2-D 
flow  equation. 


AppII-23 


Subroutine  LINEAR 

This  subroutine  is  to  determine  a  functional  value  through  linear  interpolation. 

Subroutine  LLTTNV  ‘  . . 

This  subroutine  is  to  solve  for  a  modified  residual  that  is  to  be  used  in  the  preconditioned  conjugate 

gradient  algorithm. 

Subroutine  LNDGEN_2  .  .  .  . 

This  subroutine  is  to  determine  node-node  and  node-element  connectivity  m  2-D  simulations,  based 

on  the  given  element  indices. 

Subroutine  LOCPLN_3 

This  subroutine  is  to  determine  the  interpolation  functions  for  a  node  that  is  located  on  a  3-D  elemen 
side,  given  the  global  coordinates  of  the  node  and  the  element  side  nodes. 


Subroutine  LOCQ_l 

This  subroutine  is  to  locate  the  target  point  and  its  velocity  for  a  tracking  path  in  a  1-D  subelement 
of  particle  tracking. 

Subroutine  LOCQ_2 

This  subroutine  is  to  locate  the  target  point  and  its  velocity  for  a  tracking  path  in  a  2-D  subelement 
of  particle  tracking.  The  available  tracking  time  left  after  this  tracking  path  is  also  computed. 


Subroutine  LOCQ2M  ,  . 

This  subroutine  is  to  locate  the  target  point  and  its  velocity  for  a  tracking  path  in  a  2-D  subelement 

of  particle  tracking.  The  available  tracking  time  left  after  this  tracking  path  is  also  computed.  It  is  used  only 
when  the  method  of  characteristics  is  employed  to  solve  the  2-D  flow  equation. 


Subroutine  LOCQ_32  , 

This  subroutine  is  to  locate  the  target  point  and  its  velocity  for  a  tracking  path  on  a  3-D  boundary 

side  when  the  tracking  along  boundary  is  being  considered.  The  available  tracking  time  left  after  this 
tracking  path  is  also  computed. 

Subroutine  LOCQ_3 

This  subroutine  is  to  locate  the  target  point  and  its  velocity  for  a  tracking  path  in  a  3-D  subelement 
of  particle  tracking  when  the  target  side  has  been  determined  to  be  triangular.  The  available  tracking  time 
left  after  this  tracking  path  is  also  computed. 

Subroutine  LOCQ_4 

This  subroutine  is  to  locate  the  target  point  and  its  velocity  for  a  tracking  path  in  a  2-D  subelement 
of  particle  tracking  when  the  target  side  has  been  determined  to  be  quadrilateral.  The  available  tracking  time 
left  after  this  tracking  path  is  also  computed. 

Subroutine  LRL_3 

This  subroutine  is  to  generate  arrays  describing  3-D  node-element  connectivity,  given  element 

indices. 

Subroutine  LRN_3 
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This  subroutine  is  to  generate  arrays  describing  3-D  node-node  connectivity,  give  element  indices. 

Subroutine  MMLOC_2 

This  subroutine  is  to  specify  the  starting  location  to  start  the  2-D  “in-element”  particle  tracking  in 
an  element. 

Subroutine  MMLOC_3 

This  subroutine  is  to  specify  the  starting  location  to  start  the  3-D  “in-element”  particle  tracking  in 
an  element. 

Subroutine  NELIM 

This  subroutine  is  to  prepare  an  array  consisting  of  nodal  numbers  from  a  set  of  element  face  data. 

Subroutine  NEWXE 

This  subroutine  is  to  determine  the  new  iteration  parameters  for  locating  the  target  point  in 
Subroutines  LOCQ_3  and  LOCQ_4. 

Subroutine  NODV_l 

This  subroutine  is  to  calculate  Manning’s  n  at  every  1-D  global  node. 

Subroutine  NODV_2 

This  subroutine  is  to  calculate  Manning’s  n  at  every  2-D  global  node. 

Subroutine  NUDZ0_1 

This  subroutine  is  to  compute  the  source  term,  which  is  coming  from  non-uniform  bed  slopes  (in  the 
case  of  kinematic  model)  or  stage  slope  (in  the  case  of  diffusive  model),  for  all  global  nodes  in  1-D 
river/stream  flow  simulations. 

Subroutine  NUDZ0_2 

This  subroutine  is  to  compute  the  source  term,  which  is  coming  from  non-uniform  bed  slopes  (in  the 
case  of  kinematic  model)  or  stage  slope  (in  the  case  of  diffusive  model),  for  all  global  nodes  in  2-D  overland 
flow  simulations. 

Subroutine  OBCOEF2M 

This  subroutine  is  to  determine  the  coefficient  of  a  characteristic  at  an  open  boundary  node.  The 
characteristic  has  been  determined  coming  from  the  outside  of  the  domain.  This  subroutine  is  needed  only 
when  the  method  of  characteristics  approach  is  taken  to  solve  2-D  overland  flow  equations. 

Subroutine  ONLINE_2 

This  subroutine  is  to  adjust  the  coordinates  of  a  specified  point  if  needed,  such  that  this  point  will 
be  located  on  the  line  segment  with  two  given  2-D  nodes  serving  as  its  end  nodes. 

Subroutine  ONLINE_3 

This  subroutine  is  to  adjust  the  coordinates  of  a  specified  point  if  needed,  such  that  this  point  will 
be  located  on  the  line  segment  with  two  given  3-D  nodes  serving  as  its  end  nodes. 

Subroutine  ONPLAN_3 

This  subroutine  is  to  adjust  the  coordinates  of  a  specified  point  if  needed,  such  that  this  point  will 
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be  located  on  the  element  side  with  three  or  four  given  nodes  serving  as  the  side  nodes. 

Subroutine  PAGEN_1 

This  subroutine  is  to  generate  1-D  pointer  arrays  needed  for  numerical  simulations. 

Subroutine  PAGEN_2 

This  subroutine  is  to  generate  2-D  pointer  arrays  needed  for  numerical  simulations. 

Subroutine  PAGEN_3 

This  subroutine  is  to  generate  3-D  pointer  arrays  needed  for  numerical  simulations. 

Subroutine  PFFCT1 

This  subroutine  is  to  determine  the  functional  value  by  interpolation  from  a  given  profile. 

Subroutine  PFFCT2 

This  subroutine  is  to  determine  the  functional  values  of  an  array  by  interpolation  from  a  senes  of 
given  profiles. 

Subroutine  PWISS 

This  subroutine  is  to  solver  the  linearized  matrix  equation  with  a  pointwise  iteration  solution 
strategy. 

Subroutine  PLANEW_3 

This  subroutine  is  to  determine  which  one  of  the  two  sides,  separated  by  a  specified  plane,  the 
particle  would  move  onto. 

Subroutine  POLYP 

This  subroutine  is  to  solve  a  modified  residual  that  is  to  be  used  in  the  preconditioned  conjugate 
gradient  algorithm. 

Subroutine  PPCG 

This  subroutine  is  to  solve  the  linearized  matrix  equation  with  the  preconditioned  conjugate  gradient 
method  by  using  a  polynomial  as  a  preconditioner. 

Subroutine  PREPAR2M 

This  subroutine  is  to  prepare  for  data  needed  to  construct  and  solve  the  set  of  algebraic  equations 
in  Subroutine  ASOLV2M. 

Subroutine  PRINTT_1 

This  subroutine  is  to  write  out  simulation  results  of  1-D  river/stream  simulations  at  desired  times. 

Subroutine  PRINTT_2 

This  subroutine  is  to  write  out  simulation  results  of  2-D  overland  simulations  at  desired  times. 

Subroutine  PRINTT_3 

This  subroutine  is  to  write  out  simulation  results  of  3-D  subsurface  simulations  at  desired  times. 

Subroutine  Q2FLUX 
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This  subroutine  is  to  perform  boundary  integration  over  a  2-D  boundary  side. 

Subroutine  Q2F1 

This  subroutine  is  to  determine  element  coefficient  matrices  and  load  vectors  to  compute  the 
gradients  of  bottom  elevation,  water  stage,  velocities,  and  Manning’s  n  in  1-D  river/stream  flow  simulations. 

Subroutine  Q2F2 

This  subroutine  is  to  determine  element  coefficient  matrices  and  load  vectors  to  compute  the 
gradients  of  the  derivatives  of  bottom  elevation  in  1-D  river/stream  flow  simulations. 

Subroutine  Q2F3 

This  subroutine  is  to  determine  element  coefficient  matrices  and  load  vectors  to  compute  the 
gradients  of  hydraulic  radius  and  average  river/stream  width  in  1-D  river/stream  flow  simulations. 

Subroutine  Q2T 

This  subroutine  is  to  determine  the  line  element  coefficient  matrices  and  load  vectors  to  sole  1-D 
transport  equation  in  the  Eulerian  step. 

Subroutine  Q3T 

This  subroutine  is  to  determine  the  triangular  element  coefficient  matrices  and  load  vectors  to  sole 
2-D  transport  equation  in  the  Eulerian  step. 

Subroutine  Q4T 

This  subroutine  is  to  determine  the  quadrilateral  element  coefficient  matrices  and  load  vectors  to  sole 
2-D  transport  equation  in  the  Eulerian  step. 

Subroutine  Q34ADBT 

This  subroutine  is  to  implement  flux-type  boundary  conditions,  Cauchy  or  Variable,  on  a  specified 
boundary  side  (quadrilateral  or  triangular)  for  the  Lagrangian  step  in  simulating  3-D  subsurface  dissolved 
chemical  transport.  The  computed  element  load  vectors  are  to  be  assembled  in  Subroutine  ADVBCT_3  in 
order  to  determine  the  Lagrangian  concentration  on  the  boundary. 

Subroutine  Q34ADBTT 

This  subroutine  is  to  implement  the  surface/subsurface  interface  boundary  condition  on  an  interface 
boundary  side  (quadrilateral  or  triangular)  for  the  Lagrangian  step  in  simulating  3-D  subsurface  dissolved 
chemical  transport.  The  computed  element  vectors  are  to  be  assembled  in  Subroutine  ADVBCT_3  in  order 
to  determine  the  Lagrangian  concentration  on  the  boundary. 

Subroutine  Q34CNV 

This  subroutine  is  to  implement  flux-type  boundary  conditions,  Cauchy,  Neumann,  or  Variable,  on 
a  specified  boundary  side  (quadrilateral  or  triangular)  for  the  Eulerican  step  in  simulating  3-D  subsurface 
dissolved  chemical  transport.  The  computed  element  matrices  and  load  vectors  are  to  be  assembled  in 
Subroutine  BCT_3  in  order  to  determine  the  intermediate  concentration  (i.e.,  (Ciw)N+1/2)  on  the  boundary. 

Subroutine  Q34CNW 

This  subroutine  is  to  implement  surface/subsurface  interface  boundary  condition  on  an  interface 
boundary  side  (quadrilateral  or  triangular)  for  the  Eulerican  step  in  simulating  3-D  subsurface  dissolved 
chemical  transport.  The  computed  element  matrices  and  load  vectors  are  to  be  assembled  in  Subroutine 
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BCT_3  in  order  to  determine  the  intermediate  concentration  (i.e.,  (Ciw)N+1/2)  on  the  boundary. 

Subroutine  Q34FM  ....  , 

This  subroutine  is  to  determine  the  element  coefficient  matrices,  including  mass  matrices  and  the 

stiffness  matrices  taking  into  account  eddy  viscosity  in  soling  2-D  dynamic  wave  model. 

Subroutine  Q34F1  , 

This  subroutine  is  to  determine  element  coefficient  matrices  and  load  vectors  to  compute  the 

gradients  of  bottom  elevation,  water  stage,  velocities,  and  Manning’s  n  in  2-D  overland  flow  simulations. 

Subroutine  Q34F2 

This  subroutine  is  to  determine  element  coefficient  matrices  and  load  vectors  to  compute  the 
gradients  of  the  derivatives  of  bottom  elevation  in  2-D  overland  flow  simulations. 

Subroutine  Q34R  ... 

This  subroutine  is  to  implement  the  river  boundary  condition  on  a  specified  boundary  side  in 

simulating  3-D  subsurface  flow.  The  computed  element  matrices  and  load  vectors  are  assembled  in 
Subroutine  BCF_3  in  order  to  compute  the  spatial  distribution  of  pressure  head  at  the  time  of  interest. 

Subroutine  Q34S  XT 

This  subroutine  is  to  implement  flux  type  boundary  conditions,  mcludmg  Cauchy,  Neumann, 

Variable,  and  surface/subsurface  interface  boundary  conditions,  on  a  specified  boundary  side  in  simulating 
3-D  subsurface  flow.  The  computed  element  load  vectors  are  assembled  in  Subroutine  BCF_3  m  order  to 
compute  the  spatial  distribution  of  pressure  head  at  the  time  of  interest. 

Subroutine  Q468DVF  n 

This  subroutine  is  to  compute  the  element  matrices  and  load  vectors  for  calculating  the  Darcy 
velocity  (specific  discharge).  The  computed  element  matrices  and  load  vectors  are  assembled  in  Subroutine 
VELT_3. 

Subroutine  Q468F  , 

This  subroutine  is  to  compute  the  element  matrices  and  load  vectors  for  solvmg  the  3-D  subsurface 

flow  equation.  The  computed  element  matrices  and  load  vectors  are  assembled  in  Subroutine  ASEMBF_3. 

Subroutine  Q468T  , 

This  subroutine  is  to  compute  the  element  matrices  and  load  vectors  for  solvmg  the  3-D  subsurface 

transport  equation  of  dissolved  chemicals  in  the  predictor  step.  The  computed  element  matrices  and  load 
vectors  are  assembled  in  Subroutine  ASEMBT_3. 

Subroutine  Q468TH 

This  subroutine  is  to  compute  the  element  load  vectors  for  computing  the  contribution  of  the 
increasing  rate  of  the  moisture  content. 

Subroutine  RAINOD_l 

This  subroutine  is  to  determine  rainfall  rate  at  1-D  global  nodes. 

Subroutine  RAINOD_2 

This  subroutine  is  to  determine  rainfall  rate  at  2-D  global  nodes. 
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Subroutine  REPLAS_2 

This  subroutine  is  to  write  the  values  of  the  first  four  arguments  into  the  last  four  arguments. 

Subroutine  REPLAS_3 

This  subroutine  is  to  write  the  values  of  the  first  six  arguments  into  the  last  six  arguments. 

Subroutine  RESJDU_1 

This  subroutine  is  to  compute  the  residual  of  the  1-D  transport  equations  of  (1)  dissolved  chemicals 
(when  ID  =  1),  (2)  particulate  chemicals  on  suspended  sediments  (when  ID  =  1),  (3)  particulate  chemicals 
on  bed  sediments  (when  ID  =  1),  and  (4)  suspended  sediments  (when  ID  =  2)  at  the  NP-th  node  (when  NP 
is  not  equal  to  zero  and  J  equals  zero)  or  the  J-th  junction  (when  NP  equals  zero  and  J  is  not  equal  to  zero). 
The  residuals  are  defined  as  follows. 


For  the  case  at  the  NP-th  node: 


(1)  For  dissolved  chemicals: 

RESCj  =  A[(CjW)N+1  -(C;W)N+1/2]  -  6t  (RHSCj)N+1  +  6t  (RHSCs)N  ie  [1,NC] 

(2)  For  particulate  chemicals  on  suspended  sediments: 

RESCk  =  a[(SdC^)n+1  ~(SnC^)N+1/2]-  8t  (RHSCk)N+1  +  6t  (RHSCk)N 

ne[l^s],  ielljy,  k=n*Nc+i 

(3)  For  particulate  chemicals  on  bed  sediments: 

RESCk  =  (MnCmb)N+1-(MnCmb)N-At(RHSCk)Ntl 
ne[l,Ns],  ie[l,Nc],  k=(n+Ns)*Ne+i 


(11.50) 


(n.5i) 


(11.52) 


(4)  For  suspended  sediments: 

RESSn  =  A(Sn)N+1/2  +  6t(RHSSn)N+1  -  6t(RHSSn)N  ne[l,Ns]  (11.53) 

where  (RHSS„)N+1  is  evaluated  with  ID = 22  in  Subroutine  RHSCOMP1 ,  whereas  (RHSS„)N  is  calculated  with 
ID  =  21. 


For  the  case  at  the  J-th  junction: 

(1)  For  dissolved  chemicals: 


RESCj  =  [(V(J)CjW(J))N+1-(V(J)Ciw(J))N]-At(RHSCi)Ntl 


ie[l,Nc] 


(2)  For  particulate  chemicals  on  suspended  sediments: 

RESCk  =  [(V(J)Sn(J)C^(J))N+1  —  (V  (J)  Sn(J)  C^(J))N  ]  —  At  (RHSCk)N*1 


ne[l,Ns],  ie[l,Nc],  k=n*Nc+i 

(3)  For  particulate  chemicals  on  bed  sediments: 


(H.54) 


(D.55) 
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(n.56) 


RESCk  =  (M,(J)C„b(J))N"-(M„(J)C1“(J))''-at(RHSC1;)'<*' 
ne[l,Ns],  ie[l,Nc],  k=(n+Ns)*Nc+i 

(4)  For  suspended  sediments: 

RESSn  =  (V(J)Sn(J))N+At(RHSSB)N+1  ne[l,Ns]  (H.57) 


Subroutine  RESIDU_2  ,  .  , 

This  subroutine  is  to  compute  the  residual  of  the  2-D  transport  equations  of  ( 1)  dissolved  chemicals 
(when  ID  =  1),  (2)  particulate  chemicals  on  suspended  sediments  (when  ID  =  1),  (3)  particulate  chemicals 
on  bed  sediments  (when  ID  =  1),  and  (4)  suspended  sediments  (when  ID  =  2)  at  the  NP-th  node.  The 
residuals  are  defined  as  follows. 


(1)  For  dissolved  chemicals: 

RESCj  =  h[(Ciw)N+1-(CiT+1/2]-8t(RHSCi)N+1  +  5t(RHSCi)N  ie[l,Nc] 

(2)  For  particulate  chemicals  on  suspended  sediments: 

RESCk  =  h[(S„C1-)'M-(S,C1‘)'**1,2]-6t(RHSCk)'w*8t(RHSCk)N 
ne[l,Ns],  ie[l,Nc],  k=n*Nc+i 

(3)  For  particulate  chemicals  on  bed  sediments: 

RESCk  =  -(MnC^)N  -At(RHSCk)N*1 

nelljg,  iellJStJ,  k=(n+N,)»Nt-n 


(11.58) 


(H.59) 


(11.60) 


(4)  For  suspended  sediments: 

RESSn  =  h(Sn)N+1/2  +  6t(RHSSn)N+1-6t(RHSSn)N  ne[l,Ns]  (D.61) 

where  (RHSSJN+1  is  evaluated  with  ID = 22  in  Subroutine  RHSCOMP1,  whereas  (RHSSJN  is  calculated  with 
ID  =  21. 


Subroutine  RESIDU_3  ,  .  . 

This  subroutine  is  to  compute  the  residual  of  the  3-D  transport  equations  of  (1)  dissolved  chemicals, 

(2)  adsorbing  sites,  and  (3)  adsorbed  chemicals. 

(1)  For  dissolved  chemicals: 


(RES') 

=  e[(CiW)N+1  -  (CjW)N  * 1/2]  -  6t  [( RHSjC  )N+ 1  -(RHSiC)N]  (if  (RHS^f^o) 


-(C,T+1/2]-6t 


(RHS,c)n 


(RHS;C)N 

(CjW)n 


(C.w)N+l/2 


(if  (RHSjC)N<o) 


(11.62) 

ie[l,N 
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(2)  For  adsorbing  sites: 


(RES/)  =  (6Sj)N+1-(eSj)N-At(RHS/)N+1 

je[ljsrs] 

(11.63) 

(3)  For  adsorbed  chemicals: 

(RES/)  =  (0  D/n+1  -(0  DpN  -  At  (RHS/)n+1 

jetl,Nd] 

(11.64) 

Subroutine  RHSCMP_1 

This  subroutine  is  to  compute  the  right-hand  side  of  the  1-D  transport  governing  equations  of  (1) 
dissolved  chemicals  (when  ID  =  1),  (2)  particulate  chemicals  on  suspended  sediments  (when  ID  =  1),  (3) 
particulate  chemicals  on  bed  sediments  (when  ID  =  1),  and  (4)  suspended  sediments  (when  ID  =  21  or  22) 
at  the  NP-th  node  (when  NP  is  not  equal  to  zero  and  J  equals  zero)  or  the  J-th  junction  (when  NP  equals  zero 
and  J  is  not  equal  to  zero).  The  right-hand  sides  are  defined  as  follows. 

For  the  case  at  the  NP-th  node: 

(1)  For  dissolved  chemicals: 

RHSCj  = 


Micw+Akiabpi+X;j4bSnACM:CMnPCmb+E  CaJI  (C;)b^Mr-Mr< 

m=l  j=l 


n=l 

Ne 


n=l 


ATA+Ak^+E  SDAk*+f,  MnPkJ+£  k^AfCj")8-’1  fl  (C^+R-I+R^ 

j — 1 


n=l 


n=l 


m=l 


(n.65) 


ie[l,Nc] 

(2)  For  particulate  chemicals  on  suspended  sediments: 

RHSCk  =  [M“.k"s„AC1w,BR„C„b-BD,,C^M“] 

"  ^LA+k^A+R-I+R1+R2JsnC^  ne[l,NJ,  i?[l,NJ,  k»n»Nc*i 

(3)  For  particulate  chemicals  on  bed  sediments: 


RHSCk  = 


t>„C«  -E„C„l  *C]M„C„b 

ne(l,N>],ie[I,NJ,  k=(n+Ns)*Nc+i 


(4)  For  suspended  sediments: 

(a)  when  ID  =  21, 

RHSS„  -  [M>PR,-PDI*M“]-[R-I-.RI  tRjS.  ne[l.NJ 

(b)  when  ID  =  22, 


(H.66) 


(11.67) 


(H.68) 
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ne[l,Ns3 


(H.69) 


RHSS„  =  |Mns+PRn-PDn+Mn 


For  the  case  at  the  J-th  junction: 

(1)  For  dissolved  chemicals: 

RHSCj  = 

Q  kc.wk  +Micw(J)  - xrv(j)c,w(j)  +MiCIW(J)  -M^d)  +Mic0W(J)  +V(J)k]ab 


k=l 


Nc 


kf 

p,-^:c*(j) 


ECs.(J)v(J) 


n=l 


N„ 


■rcw) 


m=l 


C^(J)  -—^-Ciw(J) 

i4b 


E  CMn(J)AJT(J)|  Cmb(J) 

n=l 


n(#7f|(# 


1C 

ie[l,Nc] 


(11.70) 


(2)  For  particulate  chemicals  on  suspended  sediments: 


NJRTH(j) 


RHSCk  =  " "XT  Q kSnC'k+M“(J)-4V(J)Sn(J)OD -k^bSn(J)V(J) 


k=l 


k’b 


(D.71) 


+Rn(J)AJT(J)Cmb(J) - Dn(J) AJT(J) C^(J)  +M‘0S(J)  ne [1,NS],  ie [1,NC],  k=n*Nc  +i 

(3)  For  particulate  chemicals  on  bed  sediments: 


RHSCk  =  [Dn(J)C^(J)-Rn(J)Cmb(J))-^(J)Mn(J)CmD(J)-kIbbM„(J) 

ne[l,Ns],ie[l,Nc],  k=(n+Ns)*Nc+i 

(4)  For  suspended  sediments: 

NJRTH(j) 

RHSSn  =  E  Q  kSnk +Mns(J)  +Mn0S(J)  +  [  Rn(J)  -Dn(J)]  AJT(J)  ne[l,Ns]  (H.73) 

k=l 


C 


(H72) 


Subroutine  RHSCMP_2 

This  subroutine  is  to  compute  the  right-hand  side  of  the  2-D  transport  governing  equations  of  (1) 
dissolved  chemicals  (when  ID  =  1),  (2)  particulate  chemicals  on  suspended  sediments  (when  ID  =  1),  (3) 
particulate  chemicals  on  bed  sediments  (when  ID  =1),  and  (4)  suspended  sediments  (when  ID  =  21  or  22) 
at  the  NP-th  node.  The  right-hand  sides  are  defined  as  follows. 

(1)  For  dissolved  chemicals: 
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RHSC.  = 


Mr  +hkiabpi+5:i4bSnhC^ECMnCIub  +  ^  k£hJl  (C/?*  +Micrw -M*" 

n-1  n=l  m=l  j-1 


X?h+Vk*+±  sBhkr+E  Mnk^f+E  kfrq-)--1  II  (CjW)amJ+R-i 

j=lj#i 


N„  Nr 

bf  .  r'  ,_rf.  /r,  w,a_,-l 


(D.74) 


C;w  ielljsrj 


n=l  n=l  m=l 

(2)  For  particulate  chemicals  on  suspended  sediments: 

RHSCk  =  [M“^,'hS,C1w*R„C„k-DtC^j-[x>*k*h.R-l]siC^ 
ne[l,Ns],  ie[l,Nc],  k=n*Nc+i 

(3)  For  particulate  chemicals  on  bed  sediments: 

RHSCk  =  [d„C^ -R.C„6 *k“M„C 

n€[l,N,],ie[l,Nc],  k=(n+Ns)*Nc+i 

(4)  For  suspended  sediments: 


(a)  when  ID  =  21, 

RHSSn 

(a)  when  ID  =  22, 


RHSSn  = 


M»***.-D»]-[R-I)S.  ne[I,N,] 
M„’*R,-D„]  «eIVNJ 


(n.75) 


<n.76> 


(n.77) 

(n.78) 


Subroutine  RHSCMP_3 

This  subroutine  is  compute  the  right  hand  side  of  the  3-D  transport  equations  of  (1)  dissolved 
chemicals,  (2)  adsorbing  sites,  and  (3)  adsorbed  chemicals. 


(1)  For  dissolved  chemicals: 
RHS;C 


=  q 


C”-Cj-]  -  *‘ec;  -  E  (a^i-b^e 

m=l 


^nccr^-cnccj')^ 


j=l 


ITS 

E(^-bi)e 


m=l 


Ns 

c  _ £ 


k^fn  (Cjw)a“j  n  (sp^  -  cii  (Cj^n  (d/-”1 

.  j=i  j=i  j-i  j-i 


jeElJSTj 


(n.79) 


(2)  For  adsorbing  sites: 
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(H80) 


RHS:S 


-  -  ajesj 


£a*e 


m=l 


cn  (c  ”>*-  fi  (sp^  -  cri  (Cj’)b"it  (op1 

j=i  j=i  j=i  j=1 


(3)  For  adsorbed  chemicals: 
RHS/ 

-  -  ^d, ♦ £  b^e 

m-1 


Nc  c  Ns  ,  Nc  .**!«  hd 

cn  (qw)‘-n  (sp*«  -  cn  <c;mi  a>p  * 

j=i  j=i  j=i  j=1 


je[l,Ns] 


(D.81) 


je[l,Nd] 


Subroutine  RINCS 

This  subroutine  is  to  read  in  chemistry  and  sediment  information. 

Subroutine  RINF_1 

This  subroutine  is  to  read  in  information  for  1-D  river/stream  flow  simulations. 

Subroutine  RINF_2 

This  subroutine  is  to  read  in  information  for  2-D  overland  flow  simulations. 

Subroutine  RINF_3 

This  subroutine  is  to  read  in  information  for  3-D  subsurface  flow  simulations. 

Subroutine  RINIT_1 

This  subroutine  is  to  read  in  the  initial  condition  for  1-D  river/stream  flow  and/or  transport 
simulations. 

Subroutine  RINIT_2 

This  subroutine  is  to  read  in  the  initial  condition  for  2-D  overland  flow  and/or  transport  simulations. 


Subroutine  RINIT_3 

This  subroutine  is  to  read  in  the  initial  condition  for  3-D  subsurface  flow  and/or  transport 
simulations. 

Subroutine  RINT_1 

This  subroutine  is  to  read  in  information  for  1-D  river/stream  transport. 

Subroutine  RINT_2 

This  subroutine  is  to  read  in  information  for  2-D  overland  transport. 

Subroutine  RINT_3 

This  subroutine  is  to  read  in  information  for  3-D  subsurface  transport. 

Subroutine  SFLOWF_3 

This  subroutine  is  to  compute  flow  fluxes  through  various  types  of  boundary  and  the  increasing  rate 
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of  moisture  content  in  the  domain  of  interest.  The  detailed  description  for  this  subroutine  can  be  found 
elsewhere  [Yeh  et  al,  1997]. 

Subroutine  SHAPE_3 

This  subroutine  is  to  compute  shape  functions  and  their  derivatives,  given  the  local  coordinates, 
natural  coordinates,  or  Cartesian  coordinates  of  the  node  of  interest  and  its  associated  element  nodes. 

Subroutine  SOL_BS 

This  subroutine  is  to  solve  the  transport  governing  equation  of  bed  sediments  at  the  NP-th 
river/stream  or  overland  node. 

Subroutine  SOL_BSJT 

This  subroutine  is  to  solve  the  transport  governing  equation  of  bed  sediments  at  the  UT-th  junction.. 

Subroutine  SOL_Cl 

This  subroutine  is  to  solve  for  the  concentrations  of  dissolved  chemicals,  particulate  chemicals  on 
suspended  sediments,  and  particulate  sediments  on  bed  sediments  at  1-D  global  nodes  (when  ID  =  1)  or  at 
junctions  (when  ID  =  2).  For  the  case  at  global  nodes,  this  subroutine  serves  as  the  corrector  step  in  our 
predictor-corrector  approach  to  solve  transport  equations  of  chemicals.  For  the  case  at  junctions,  the 
governing  equations  accounting  for  chemical  interactions  are  solved  in  this  subroutine.  The  Newton- 
Raphson  method  is  employed  to  solve  the  nonlinear  system  of  chemical  reactions.  The  full-pivoting 
technique  is  incorporated  into  a  direct  solver  to  handle  linearized  matrix  equations. 

Subroutine  SOL_C2 

This  subroutine  is  to  solve  for  the  concentrations  of  dissolved  chemicals,  particulate  chemicals  on 
suspended  sediments,  and  particulate  sediments  on  bed  sediments  at  2-D  global  nodes.  This  subroutine 
serves  as  the  corrector  step  in  our  predictor-corrector  approach  to  solve  transport  equations  of  chemicals. 
The  Newton-Raphson  method  is  employed  to  solve  the  nonlinear  system  of  chemical  reactions.  The  full- 
pivoting  technique  is  incorporated  into  a  direct  solver  to  handle  linearized  matrix  equations. 

Subroutine  SOL_C3 

This  subroutine  is  to  solve  for  the  concentrations  of  dissolved  chemicals,  adsorbing  sites,  and 
adsorbed  chemicals  at  3-D  global  nodes.  This  subroutine  serves  as  the  corrector  step  in  our  predictor- 
corrector  approach  to  solve  transport  equations  of  chemicals.  The  Newton-Raphson  method  is  employed  to 
solve  the  nonlinear  system  of  chemical  reactions.  The  full-pivoting  technique  is  incorporated  into  a  direct 
solver  to  handle  linearized  matrix  equations. 

Subroutine  SOLJSS1 

This  subroutine  is  to  solve  the  concentrations  of  suspended  sediments  at  the  NP-th  river/stream  node 
in  the  corrector  step,  where  the  time-implicit  scheme  is  employed. 

Subroutine  SOL.SS2 

This  subroutine  is  to  solve  the  concentrations  of  suspended  sediments  at  the  NP-th  overland  node 
in  the  corrector  step,  where  the  time-implicit  scheme  is  employed. 

Subroutine  SOLJSSJT 

This  subroutine  is  to  solve  the  concentrations  of  suspended  sediments  at  the  DT-th  junction,  where 
the  time-implicit  scheme  is  employed. 
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Subroutine  SORT  . 

This  subroutine  is  to  compress  the  material  ED  so  that  there  is  no  skip  number  in  the  material  IDs  and 

the  material  ID  is  expected  to  increase  sequentially  from  1  to  the  number  of  materials. 

Subroutine  SPROP_3  .  . 

This  subroutine  is  to  compute  moisture  content,  water  capacity,  and  hydraulic  conductivity  in  all 

subsurface  elements. 


Subroutine  STAR2M 

This  subroutine  is  to  determine  the  Lagrangian  values  (i.e.,  H! ,  u, , 
appeared  in  Section  3.2.1)  associated  with  each  characteristic. 


Subroutine  STORE_lD 

This  subroutine  is  to  store  the  computer  results  of  1-D  river/stream  in  a  binary  file  for  further  plotting 


purposes. 

Subroutine  STORE_2D 

This  subroutine  is  to  store  the  computer  results  of  2-D  overland  in  a  binary  file  for  further  plotting 
purposes. 


Subroutine  STORE_3D 

This  subroutine  is  to  store  the  computer  results  of  3-D  subsurface  in  a  binary  file  for  further  plotting 
purposes. 


Subroutine  STRIP 

This  subroutine  is  to  read  in  a  character  variable. 


Subroutine  SURE_2 

This  subroutine  is  to  analytically  determine  the  target  location  of  a  2-D  tracking  path  when  the 
single-velocity  approach  is  applied. 

Subroutine  SURE2M 

This  subroutine  is  to  analytically  determine  the  target  location  of  a  2-D  tracking  path  when  the 
single-velocity  approach  is  applied.  It  is  used  only  when  the  method  of  characteristics  is  employed  to  solve 
the  2-D  flow  equation. 

Subroutine  SUR2D3 

This  subroutine  is  to  analytically  determine  the  target  location  of  a  2-D  tracking  path  on  a  3-D 
boundary  side  when  the  single-velocity  approach  is  applied. 

Subroutine  SURE_3 

This  subroutine  is  to  analytically  determine  the  target  location  of  a  3-D  tracking  path  when  the 
single-velocity  approach  is  applied. 

Subroutine  SURF_2 

This  subroutine  is  to  generate  boundary  arrays  for  implementing  boundary  conditions  in  2-D 
simulations. 
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Subroutine  SURF_3 

This  subroutine  is  to  generate  boundary  arrays  for  implementing  boundary  conditions  in  3-D 
simulations. 

Subroutine  THNODE_3 

This  subroutine  is  to  compute  moisture  content  at  all  subsurface  nodes. 

Subroutine  TRAKV1 

This  subroutine  is  to  determine  the  tracking  velocity  for  implementation  of  the  Lagrangian  step  of 
1-D  river/stream  flow  computation 

Subroutine  TRAK_1 

This  subroutine  is  to  determine  the  target  location  of  a  tracking  path  in  a  1-D  subelement. 
Subroutine  TRAK_21 

This  subroutine  is  to  determine  (1)  whether  or  not  a  particle  will  pass  through  the  working 
subelement  being  considered  and  (2)  the  location  of  the  target  location  if  the  particle  will  pass  through  the 
working  subelement.  This  subroutine  is  employed  when  the  starting  location  is  where  an  subelement  node 
is  located. 

Subroutine  TRAK_22 

This  subroutine  is  to  determine  (1)  whether  or  not  a  particle  will  pass  through  the  working 
subelement  being  considered  and  (2)  the  location  of  the  target  location  if  the  particle  will  pass  through  the 
working  subelement.  This  subroutine  is  employed  when  the  starting  location  is  not  where  an  subelement 
node  is  located. 

Subroutine  TRAK21M 

This  subroutine  is  to  determine  (1)  whether  or  not  a  particle  will  pass  through  the  working 
subelement  being  considered  and  (2)  the  location  of  the  target  location  if  the  particle  will  pass  through  the 
working  subelement.  This  subroutine  is  employed  when  the  starting  location  is  where  an  subelement  node 
is  located.  It  is  used  only  when  the  method  of  characteristics  is  employed  to  solve  the  2-D  flow  equation. 

Subroutine  TRAK22M 

This  subroutine  is  to  determine  (1)  whether  or  not  a  particle  will  pass  through  the  working 
subelement  being  considered  and  (2)  the  location  of  the  target  location  if  the  particle  will  pass  through  the 
working  subelement.  This  subroutine  is  employed  when  the  starting  location  is  not  where  an  subelement 
node  is  located.  It  is  used  only  when  the  method  of  characteristics  is  employed  to  solve  the  2-D  flow 
equation. 

Subroutine  TRAK_31H 

This  subroutine  is  to  determine  (1)  whether  or  not  a  particle  will  pass  through  the  working 
subelement  being  considered  and  (2)  the  location  of  the  target  location  if  the  particle  will  pass  through  the 
working  hexahedral  subelement.  This  subroutine  is  employed  when  the  starting  location  is  where  an 
subelement  node  is  located. 

Subroutine  TRAK_31P 

This  subroutine  is  to  determine  (1)  whether  or  not  a  particle  will  pass  through  the  working 
subelement  being  considered  and  (2)  the  location  of  the  target  location  if  the  particle  will  pass  through  the 
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working  triangular  prism  subelement.  This  subroutine  is  employed  when  the  starting  location  is  where  an 
subelement  node  is  located. 

Subroutine  TRAKJJ1T 

This  subroutine  is  to  determine  (1)  whether  or  not  a  particle  will  pass  through  the  working 
subelement  being  considered  and  (2)  the  location  of  the  target  location  if  the  particle  will  pass  through  the 
working  tetrahedral  subelement.  This  subroutine  is  employed  when  the  starting  location  is  where  an 
subelement  node  is  located. 

Subroutine  TRAKJJ2H 

This  subroutine  is  to  determine  (1)  whether  or  not  a  particle  will  pass  through  the  working 
subelement  being  considered  and  (2)  the  location  of  the  target  location  if  the  particle  will  pass  through  the 
working  hexahedral  subelement.  This  subroutine  is  employed  when  the  starting  location  is  not  where  an 
subelement  node  is  located. 

Subroutine  TRAK_32P 

This  subroutine  is  to  determine  (1)  whether  or  not  a  particle  will  pass  through  the  working 
subelement  being  considered  and  (2)  the  location  of  the  target  location  if  the  particle  will  pass  through  the 
working  triangular  prism  subelement.  This  subroutine  is  employed  when  the  starting  location  is  not  where 
an  subelement  node  is  located. 

Subroutine  TRAKJ32T 

This  subroutine  is  to  determine  (1)  whether  or  not  a  particle  will  pass  through  the  working 
subelement  being  considered  and  (2)  the  location  of  the  target  location  if  the  particle  will  pass  through  the 
working  tetrahedral  subelement.  This  subroutine  is  employed  when  the  starting  location  is  not  where  an 
subelement  node  is  located. 

Subroutine  TRANSP_1 

This  subroutine  serves  as  the  control  panel  to  compute  both  chemical  and  sediment  transport  of  1-D 
river/stream.  The  predictor-corrector  numerical  approach  is  employed  to  solve  the  transport  equations  of 
mobile  materials,  such  as  dissolved  chemicals,  suspended  sediments,  and  particulate  chemicals  on  suspended 
sediments.  During  each  time  step.  The  predictor  step  is  first  implemented  to  obtain  the  intermediate  values 
for  mobile  materials.  Sediment  equations  are  then  solved  by  using  the  Picard  to  handle  their  nonlinearity. 
The  concentrations  of  chemicals  are  the  last  to  solve  for.  The  set  of  nonlinear  ordinary  differential  equations 
is  solved  with  the  Newton-Raphson  method  node  by  node  in  the  corrector  step. 

Subroutine  TRANSPJ2 

This  subroutine  serves  as  the  control  panel  to  compute  both  chemical  and  sediment  transport  of  2-D 
overland.  The  predictor-corrector  numerical  approach  is  employed  to  solve  the  transport  equations  of  mobile 
materials,  such  as  dissolved  chemicals,  suspended  sediments,  and  particulate  chemicals  on  suspended 
sediments.  During  each  time  step.  The  predictor  step  is  first  implemented  to  obtain  the  intermediate  values 
for  mobile  materials.  Sediment  equations  are  then  solved  by  using  the  Picard  to  handle  their  nonlinearity. 
The  concentrations  of  chemicals  are  the  last  to  solve  for.  The  set  of  nonlinear  ordinary  differential  equations 
is  solved  with  the  Newton-Raphson  method  node  by  node  in  the  corrector  step. 

Subroutine  TRANSP_3 

This  subroutine  serves  as  the  control  panel  to  compute  chemical  transport  of  3-D  subsurface.  The 
predictor-corrector  numerical  approach  is  employed  to  solve  the  transport  equations  of  mobile  materials,  such 
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as  dissolved  chemicals.  During  each  time  step.  The  predictor  step  is  first  implemented  to  obtain  the 
intermediate  values  for  mobile  materials.  The  set  of  nonlinear  ordinary  differential  equations  that  is 
accounting  for  the  reaction  rates  of  dissolved  chemicals,  adsorbing  sites,  and  adsorbed  chemicals  is  solved 
with  the  Newton-Raphson  method  node  by  node  in  the  corrector  step. 

Subroutine  TRILRN2M 

This  subroutine  is  to  generate  pointer  arrays  for  the  use  in  constructing  the  matrix  equation  for 
adjusting  2-D  flow  velocity  in  the  last  part  of  the  method  of  characteristic  approach. 

Subroutine  TSCONV 

This  subroutine  is  to  retrieve  desired  profiles  from  given  x-y  series  curves. 

Subroutine  TSCONW 

This  subroutine  is  to  retrieve  desired  profiles  from  given  x-y  series  curves. 

Subroutine  TSCONV2 

This  subroutine  is  to  retrieve  desired  profiles  from  given  x-y  series  curves. 

Subroutine  VALBDL_2 

This  subroutine  is  to  compute  the  velocity  at  a  specified  2-D  node  by  interpolation. 

Subroutine  VALBDL2M 

This  subroutine  is  to  compute  the  velocity  at  a  specified  2-D  node  by  interpolation.  It  is  used  only 
when  the  method  of  characteristics  is  employed  to  solve  the  2-D  flow  equation. 

Subroutine  VELT_1 

This  subroutine  is  to  compute  the  kinematic  or  diffusion  velocities  at  all  river/stream  nodes. 
Subroutine  VELTJ2 

This  subroutine  is  to  compute  the  kinematic  or  diffusion  velocities  at  all  overland  nodes. 
Subroutine  VELT_3 

This  subroutine  is  to  compute  the  Darcy  velocity  (specific  discharge)  at  all  subsurface  nodes.  The 
mass-lumping  technique  is  employed. 

Subroutine  VOLUME 

This  subroutine  is  to  compute  the  volume  of  a  3-D  element,  given  the  coordinates  of  element  nodes 
and  element  indices. 

Subroutine  WRKARY_2 

This  subroutine  is  to  prepare  working  arrays  for  particle  tracking  in  either  a  2-D  element  or  a  2-D 
subelement. 

Subroutine  WRKARY2M 

This  subroutine  is  to  prepare  working  arrays  for  particle  tracking  in  either  a  2-D  element  or  a  2-D 
subelement.  It  is  employed  only  when  the  method  of  characteristics  is  employed  to  solve  the  2-D  flow 
equation. 
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Subroutine  WRKARY_3  ...  _ 

This  subroutine  is  to  prepare  working  arrays  for  particle  tracking  in  either  a  3-D  element  or  a  3-D 

subelement. 

Subroutine  XSI_2 

This  subroutine  is  to  determine  the  local  coordinates  of  a  specified  node  that  is  located  in  a  2-D 
quadrilateral  element,  given  the  original  Cartesian  coordinates  of  both  the  node  and  element  nodes. 


Subroutine  XSI_3 

This  subroutine  is  to  determine  the  local  coordinates  of  a  specified  node  that  is  located  in  a  3-D 
hexahedral  element,  given  the  original  Cartesian  coordinates  of  both  the  node  and  element  nodes. 

Subroutine  XSI_3P 

This  subroutine  is  to  determine  the  local/natural  coordinates  of  a  specified  node  that  is  located  in  a 
3-D  triangular  prism  element,  given  the  original  Cartesian  coordinates  of  both  the  node  and  element  nodes. 
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Appendix  m.  PARAMETERS  FOR  RUNNING  THE  COMPUTER  CODE 


The  following  is  the  content  of  the  including  file,  wmsl23anc,  which  is  required  to  compile  and  run 
the  computer  code  of  the  model.  One  needs  to  modify  wmsl23.inc  in  order  to  provide  appropriate  values 
for  the  code  parameters  as  defined  as  follows. 


- CONTROL  INTEGERS  FOR  THE  SPATIAL  DOMAIN  OF  2-D  OVERLAND  FLOW 

MAXNPK2  :  MAX.  NO.  OF  NODES 

MAXELK2  :  MAX.  NO.  OF  ELEMENTS 

MXBNPK2  :  MAX.  NO.  OF  BOUNDARY  NODAL  POINTS 

MXBESK2  :  MAX.  NO.  OF  BOUNDARY  ELEMENT  SIDES 

MXJBDK2  :  MAX.  NO.  OF  GLOBAL  NODES  NEEDED  TO  DESCRIBE  THE  NODE-NODE  CONNECTIVITY 
MXKBDK2  :  MAX.  NO.  OF  GLOBAL  ELEMENT  NEEDED  TO  DESCRIBE  NODE-ELEMENT  CONNECTIVITY 

PARAMETER  (MAXNPK2=275,MAXELK2=462,MXBNPK2=1000,MXBESK2=1000) 

PARAMETER  (MXJBDK2=20,MXKBDK2=20) 

- CONTROL  INTEGERS  FOR  THE  TIME  DOMAIN  OF  2-D  OVERLAND  FLOW 

MXNTK2  :  MAX.  NO.  OF  TIME  STEPS 
MXDTCK2  :  MAX.  NO.  OF  DELT  CHANGES 

PARAMETER  (MXNTK2=50000,MXDTCK2=20) 

- CONTROL  INTEGERS  FOR  MATERIAL  PROPERTIES  OF  2-D  OVERLAND  FLOW 

MXMATK2  :  MAX.  NO.  OF  MATERIAL  TYPES 

MXMPMK2  :  MAX.  NO.  OF  MATERIAL  PROPERTIES  PER  MATERIAL 

PARAMETER  (MXMATK2=10,MXMPMK2=6) 

—  CONTROL  INTEGERS  FOR  RAINFALL  OF  2-D  OVERLAND  FLOW 

MXRESK2  :  MAX.  NO.  OF  ELEMENTS  WITH  RAINFALL  CONDITION 

MXRPRK2  :  MAX.  NO.  OF  RAINFALL  PROFILES 

MXRDPK2  :  MAX.  NO.  OF  DATA  POINTS  ON  THE  RAINFALL  PROFILE 

PARAMETER  (MXRESK2=MAXELK2,MXRPRK2=5,MXRDPK2=200) 

—  CONTROL  INTEGERS  FOR  SOURCE/SINK  OF  2-D  OVERLAND  FLOW 

MXSPRK2  :  MAX.  NO.  OF  SOURCE/SINK  PROFILES 

MXSDPK2  :  MAX.  NO.  OF  DATA  POINTS  ON  THE  SOURCE/SINK  PROFILE 

PARAMETER  (MXSPRK2=5,MXSDPK2=200) 

—  CONTROL  INTEGERS  FOR  OPEN  BOUNDARY  CONDITIONS  OF  2-D  OVERLAND  FLOW 

MXDNPK2  :  MAX.  NO.  OF  DIRICHLET  BOUNDARY  NODAL  POINTS 
MXDPRK2  :  MAX.  NO.  OF  DIRICHLET  BOUNDARY  PROFILES 
MXDDPK2  :  MAX.  NO.  OF  DATA  POINTS  IN  A  DIRICHLET  PROFILES 
MXCESK2  :  MAX.  NO.  OF  FLUX-TYPE  BOUNDARY  SIDES. 

MXFPRK2  :  MAX.  NO.  OF  UPSTREAM  BOUNDARY  FLUX  PROFILES 

MXFDPK2  :  MAX.  NO.  OF  DATA  POINTS  IN  A  UPSTREAM  BOUNDARY  PROFILE 

MXCPRK2  :  MAX.  NO.  OF  DEPTH-  OR  STAGE-DEPENDENT  FLUX  PROFILES 

MXCDPK2  :  MAX.  NO.  OF  DATA  POINTS  IN  A  DEPTH-  OR  STAGE-DEPENDENT  FLUX  PROFILE 

PARAMETER  (MXDNPK2=500,MXDPRK2=10,MXDDPK2=500) 

PARAMETER  (MXCESK2=500,MXFPRK2=  1 0,MXFDPK2=300) 

PARAMETER  <MXCPRK2=3,MXCDPK2=300) 
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_ CONTROL  INTEGERS  FOR  IMPERMEABLE  BOUNDARY  CONDITIONS  OF  2-D  OVERLAND  FLOW 

MXIBPK2  :  MAX.  NO.  OF  IMPERMEABLE  BOUNDARY  NODAL  POINTS 
PARAMETER  (MXIBPK2=500) 

- CONTROL  INTEGERS  FOR  SUB-ELEMENT  TRACKING  OF  2-D  OVERLAND  FLOW 

MXNPWK2  :  MAX.  NO.  OF  NODES  FOR  A  SUB-ELEMENT  TRACKING 
MXELWK2  :  MAX.  NO.  OF  SUB-ELEMENTS  FOR  A  SUB-ELEMENT  TRACKING 

PARAMETER  (MXNPWK2=121,MXELWK2=100) 

- CONTROL  INTEGERS  FOR  HYDROGRAPH  OF  2-D  OVERLAND  FLOW 

MXPNTK2  :  MAX.  NO.  OF  NODAL  POINTS  FOR  THE  LINE  CROSS  SECTION 
MXUNK2  :  MAX.  NO.  OF  LINE  CROSS  SECTION  CAN  BE  SELECTED 
MXTTPK2  :  MAX.  NO.  OF  DATA  POINTS  ON  THE  HYDROGRAPH 

PARAMETER  (MXPNTK2=50,MXLINK2=10,MXriPK2=100) 

- CONTROL  INTEGERS  FOR  2-D  OVERLAND  TRANSPORT 

MXMMMK2  :  MAX.  NO.  OF  MATERIAL  PROPERTIES  PERMATERIAL  FOR  TRANSPORT 
MXSRPRK2  :  MAX.  NO.  OF  SOURCE/SINK  PROFILES 

MXSRDPK2  :  MAX.  NO.  OF  DATA  POINTS  USED  TO  DESCRIBE  A  SOURCE/SINK  PROFILE 
MXCESTK2  :  MAX.  NO.  OF  FLUX-TYPE  BOUNDARY  SIDES  OF  TRANSPORT 
MXCPRTK2  :  MAX.  NO.  OF  FLUX-TYPE  BOUNDARY  CONDITION  PROFILES  OF  TRANSPORT 
MXCDPTK2  :  MAX.  NO.  OF  DATA  POINTS  USED  TO  DESCRIBE  A  FLUX-TYPE  BOUNDARY 
CONDITION  PROFILE  OF  TRANSPORT 

MXDNPTK2  :  MAX.  NO.  OF  DIRICHLET  BOUNDARY  NODES  OF  TRANSPORT 
MXDPRTK2 :  MAX.  NO.  OF  DIRICHLET  BOUNDARY  CONDITION  PROFILES  OF  TRANSPORT 
MXDDPTK2  :  MAX.  NO.  OF  DATA  POINTS  USED  TO  DESCRIBE  A  DIRICHLET  BOUNDARY 
CONDITION  PROFILE  OF  TRANSPORT 

MXRCPRK2  :  MAX.  NO.  OF  CHEMICAL  CONCENTRATION  PROFILES  IN  RAINFALL 
MXRCDPK2  :  MAX.  NO.  OF  DATA  POINTS  USED  TO  DESCRIBE  A  CHEMICAL  CONCENTRATION 
PROFILES  IN  RAINFALL 

PARAMETER  (MXMMMK2=3) 

PARAMETER  (MXSRPRK2=20,MXSRDPK2=20) 

PARAMETER  (MXRCPRK2=20,MXRCDPK2=20) 

PARAMETER  (MXDNPTK2=200,MXDPRTK2=200,MXDDPTK2=100) 

PARAMETER  (MXCESTK2=200,MXCPRTK2=200,MXCDPTK2=  1 00) 

- CONTROL  INTEGERS  FOR  THE  SPATIAL  DOMAIN  OF  1-D  CHANNEL  FLOW 

MAXNPK1  :  MAX.  NO.  OF  NODES 
MAXELK1  :  MAX.  NO.  OF  ELEMENTS 

PARAMETER  (MAXNPK1=500,MAXELK1=500) 

- CONTROL  INTEGERS  FOR  THE  TIME  DOMAIN  OF  1-D  CHANNEL  FLOW 

MXNTK1  :  MAX.  NO.  OF  TIME  STEPS 
MXDTCK1  :  MAX.  NO.  OF  DELT  CHANGES 

PARAMETER  (MXNTK1=5000>1XDTCK1=20) 

- CONTROL  INTEGERS  FOR  MATERIAL  PROPERTIES  OF  1-D  CHANNEL  FLOW 

MXMATK1  :  MAX.  NO.  OF  MATERIAL  TYPES 

MXMPMK1  :  MAX.  NO.  OF  MATERIAL  PROPERTIES  PER  MATERIAL 

PARAMETER  (MXMATK1=10,MXMPMK1=6) 

C 
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C CONTROL  INTEGERS  FOR  RAINFALL  OF  1  -D  CHANNEL  FLOW 

C 

C  MXRESK1  :  MAX.  NO.  OF  ELEMENTS  WITH  RAINFALL  CONDITION 
C  MXRPRK1  :  MAX.  NO.  OF  RAINFALL  PROFILES 
C  MXRDPK1  :  MAX.  NO.  OF  DATA  POINTS  ON  THE  RAINFALL  PROFILE 
C 

PARAMETER  (MXRESK1=MAXELK1,MXRPRK1=5,MXRDPK1=200) 

C 

C CONTROL  INTEGERS  FOR  SOURCE/SINK  OF  1-D  CHANNEL  FLOW 

C 

C  MXSPRK1  :  MAX.  NO.  OF  SOURCE/SINK  PROFILES 
C  MXSDPK1  :  MAX.  NO.  OF  DATA  POINTS  ON  THE  SOURCE/SINK  PROFILE 
C  MXSJPRK1  :  MAX.  NO.  OF  SOURCE/SINK  PROFILES  AT  JUNCTIONS 
C  MXSJDPK1  :  MAX.  NO.  OF  DATA  POINTS  ON  THE  SOURCE/SINK  PROFILE 
C  AT  JUNCTIONS 

C 

PARAMETER  (MXSPRK1  =5.MXSDPK1 =200) 

PARAMETER  (MXSJPRK1  =5  JvlXS  JDPK1 =200) 

C 

C CONTROL  INTEGERS  FOR  OPEN  BOUNDARY  CONDITIONS  OF  1-D  CHANNEL 

C  FLOW 
C 

C  MXDNPK1  :  MAX.  NO.  OF  OPEN  BOUNDARY  NODAL  POINTS 
C  MXDPRK1  :  MAX.  NO.  OF  OPEN  BOUNDARY  PROFILES 
C  MXDDPK1  :  MAX.  NO.  OF  DATA  POINTS  ON  THE  PROFILES 
C 

PARAMETER  (MXDNPK1=500,MXDPRK1=50,MXDDPK1=300) 

PARAMETER  (MXCPRK1=10.MXCDPK1=300) 

C 

C - CONTROL  INTEGERS  FOR  1-D  CHANNEL  REACH  NUMBER 

C 

C  MXRHK1  :  MAX.  NO.  OF  CHANNEL  REACH  NUMBER 
C  MXRHNPK1  :  MAX.  NO.  OF  NODES  INCLUDED  IN  A  CHANNEL  REACH 
C 

PARAMETER  (MXRHK1=10,MXRHNPK1=100) 

C 

C CONTROL  INTEGERS  FOR  CROSS-SECTIONAL  GEOMETRY  FOR  1-D  CHANNEL  FLOW 

C 

C  MXCNPK1  :  MAX.  NO.  OF  DATA  POINTS  FOR  CROSS-SECTIONAL  GEOMETRY  PROFILES 
C 

PARAMETER  (MXCNPK1=200) 

C 

C CONTROL  INTEGERS  FOR  CHANNEL  JUNCTIONS 

C 

C  MXJTK1  :  MAX.  NO.  OF  CHANNEL  JUNTIONS 

C  MXJTRK1  :  MAX.  NO.  OF  CHANNEL  REACHES  CONNECTED  TO  A  JUNCTION 
C  MXJTPK1  :  MAX.  NO.  OF  CHANNEL  JUNCTION  PROFILES 
C  MXJTDK1  :  MAX.  NO.  OF  DATA  POINTS  ON  THE  PROFILES 

C  MXNJTSK1  :  MAX.  NO.  OF  JUNCTION-RELATED  OVERLAND  BOUNDARY  SIDES  TO  A  JUNCTION 
C 

PARAMETER  (MXJTK 1 =500,MXJTRK  1  =50,MXJTPK  1  =50,MXJTDK  1=100) 

PARAMETER  (MXNJTSK1=50) 

C 

C CONTROL  INTEGERS  FOR  SUB-ELEMENT  TRACKING  FOR  1-D  CHANNEL  FLOW 

C 

C  MXNPWK1  :  MAX.  NO.  OF  NODES  FOR  A  SUB-ELEMENT  TRACKING 
C 

PARAMETER  (MXNPWK1=1 1) 

C 

C CONTROL  INTEGERS  FOR  HYDROGRAPH  OF  1-D  CHANNEL  FLOW 

C 

C  MXPNTK1  :  MAX.  NO.  OF  NODAL  POINTS  FOR  THE  LINE  CROSS  SECTION 
C  MXUNK1  :  MAX.  NO.  OF  LINE  CROSS  SECTION  CAN  BE  SELECTED 
C  MXTTPK1  :  MAX.  NO.  OF  DATA  POINTS  ON  THE  HYDROGRAPH 
C 


AppIH-3 


onnnn  oooooo  onooooooonoooooooonoo  nnnnnnnnnnnnnnnnn 


PARAMETER  (MXPNTKl=50JHXLINKl=10JVlXnPKl=100) 

- CONTROL  INTEGERS  FOR  1-D  CHANNEL  TRANSPORT 

MXMMMK1  :  MAX.  NO.  OF  MATERIAL  PROPERTIES  PER  MATERIAL  FOR  TRANSPORT 
MXSRPRK1  :  MAX.  NO.  OF  SOURCE/SINK  PROFILES 

MXSRDPK1 :  MAX.  NO.  OF  DATA  POINTS  USED  TO  DESCRIBE  A  SOURCE/SINK  PROFILE 
MXSJRTK1 :  MAX.  NO.  OF  SOURCE/SINK  PROFILES  OF  TRANSPORT  AT  JUNCTIONS 
MXSJDTK1  :  MAX.  NO.  OF  DATA  POINTS  USED  TO  DESCRIBE  A  SOURCE/SINK  PROFILE 
OF  TRANSPORT  AT  JUNCTIONS 

MXDNPTK1  :  MAX.  NO.  OF  DIRICHLET  BOUNDARY  NODES  OF  TRANSPORT 
MXBPPRK1  :  MAX.  NO.  OF  BOUNDARY  CONDITION  PROFILES 

MXBPDPK1  :  MAX.  NO.  OF  DATA  POINTS  USED  TO  DESCRIBE  A  BOUNDARY  CONDITION 
PROFILE 

MXRCPRK1  :  MAX.  NO.  OF  CHEMICAL  CONCENTRATION  PROFILES  IN  RAINFALL 
MXRCDPK1 :  MAX.  NO.  OF  DATA  POINTS  USED  TO  DESCRIBE  A  CHEMICAL  CONCENTRATION 
PROFILES  IN  RAINFALL 

PARAMETER  (MXMMMK1=2) 

PARAMETER  (MXSRPRK1  =20,MXSRDPK  1=20) 

PARAMETER  (MXSJRTK1  =5,MXSJDTK1 =200) 

PARAMETER  (MXBPPRK1=20,MXBPDPK1=20) 

PARAMETER  (MXAPPRK1  =20MXAPDPK1  =20) 

PARAMETER  (MXRCPRK1  =20,MXRCDPK1  =20) 

PARAMETER  (MXDNPTK1=20) 

- CONTROL  INTEGERS  FOR  CHEMICAL  AND  SEDIMENT  TRANSPORT 

MXNRXK  :  MAX.  NO.  OF  AQUEOUS  COMPLEXATION  REACTIONS 
MXNRXSK  :  MAX.  NO.  OF  ADSORPTION  REACTIONS  IN  THE  3-D  SUBSURFACE 
mxnchk  :  max.  no.  of  Dissolved  chemicals 

MXNSK  :  MAX.  NO.  OF  SEDIMENT  SEES 

MXTNCK  :  MAX.  NO.  OF  DISSOLVED  CHEMICALS  AND  PARTICULATE  CHEMICALS 
MXTNSK  :  MAX.  NO.  OF  SUSPENDED  AND  BED  SEDIMENT  SEES 
MXTSRK  :  MAX.  NO.  OF  DISSOLVED  CHEMICALS,  SUSPENDED  SEDIMENTS, 

AND  PARTICULATE  CHEMICALS  ON  THE  SUSPENDED  SEDIMENT 
MXNSITK  :  MAX.  NO.  OF  ADSORBING  SITES  IN  THE  3-D  SUBSURFACE 
MXNSORK  :  MAX.  NO.  OF  ADSORBED  CHEMICALS  IN  THE  3-D  SUBSURFACE 
MXNCSK  :  MAX.  NO.  OF  DISSOLVED  CHEMICALS,  ADSORBING  SITES,  AND 
ADSORBED  CHEMICALS 

MXTCSK  :  MAX.  NO.  OF  DISSOLVED  CHEMICALS,  SUSPENDED  CHEMICALS, 

ADSORBING  SITES,  AND  ADSORBED  CHEMICALS 
MXAPPRK  :  MAX.  NO.  OF  PARTIAL  ATMOSPHERIC  PRESSURE  PROFILES 
MXAPDPK  :  MAX.  NO.  OF  DATA  POINTS  USED  TO  DESCRIBE  A  PARTIAL 
ATMOSPHERIC  PRESSURE 


PARAMETER  (MXNRXK=10,MXNCHK=10,MXNSK=5) 

PARAMETER  (MXNRXSK=1 0,MXNSITK=  1 0,MXNSORK=1 0) 

PARAMETER  (MXTNCK=MXNCHK*(MXNSIK*2+1),MXTNSK=MXNSIK*2) 
PARAMETER  (MXNCSK=MXNCHK+MXNSI7K+MXNSORK) 

PARAMETER  (MXTCSK=MXTNCK+MXNSITK+MXNSORK) 

PARAMETER  (MXTSRK=MXNCHK+MXNSK+MXNCHK*MXNSIK) 
PARAMETER  (MXAPPRK=20,MXAPDPK=20) 

- CONTROL  INTEGERS  FOR  DESCRIBING  FUNCTIONAL  CURVES 

MXXYSK  :  MAX.  NO.  OF  CURES/SERIES 

MXXYPK  :  MAX.  NO.  OF  DATA  POINTS  FOR  THE  CURVES 

PARAMETER  (MXXYSK=300,MXXYPK=500) 

- CONTROL  INTEGERS  FOR  BOTH  3-D  FLOW  AND  3-D  TRANSPORT 

MXSNP  :  MAX.  NO.  OF  3-D  GLOBAL  NODES 
MXSEL  :  MAX.  NO.  OF  3-D  GLOBAL  ELEMENTS 
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C  MXSBNP  :  MAX.  NO.  OF  3-D  BOUNDARY  NODES 
C  MXSBES  .  MAX.  NO.  OF  3-D  BOUNDARY  ELEMENT  SIDES 
C  MXSTUBS  :  MAX.  NO.  OF  3-D  TOTAL  UNSPECIFIED  BOUNDARY  SIDES 

C  MXSJBD  :  MAX.  NO.  OF  GLOBAL  NODES  NEEDED  TO  DESCRIBE  THE  NODE-NODE  CONNECTIVITY 
C  MXSKBD  :  MAX.  NO.  OF  GLOBAL  ELEMENT  NEEDED  TO  DESCRIBE  NODE-ELEMENT  CONNECTIVITY 
C  MXSNTI  :  MAX.  NO.  OF  TIME  STEP  SIZE 
C  MXSDTC  :  MAX.  NO.  OF  THE  CHANGE  OF  TIME  STEP  SIZE 
C  MXSMAT  :  MAX.  NO.  OF  MATERIAL  TYPE 

C  MXSSPPM  :  MAX.  NO.  OF  PARAMETERS  NEEDED  TO  DESCRIBE  PROPERTIES  RELATED  TO  FLOW 
C  COMPUTATION  FOR  ANY  MATERIAL 

C  MXSMPPM  :  MAX.  NO.  OF  PARAMETERS  NEEDED  TO  DESCRIBE  PROPERTIES  RELATED  TO  TRANSPORT 
C  COMPUTATION  FOR  ANY  MATERIAL 

C  MXSRMP  :  MAX.  NO.  OF  PARAMETERS  NEEDED  TO  DESCRIBE  PROPERTIES  RELATED  TO  THE 
C  IMPLEMENTATION  OF  RIVER  BOUNDARY  CONDITIONS  IN  FLOW  COMPUTATION  FOR  ANY 

C  RIVER  BED  MATERIAL 

C 

PARAMETER(MXSNP=2079,MXSEL=2400,MXSBNP=882MXSBES=880) 

PARAMETER  (MXSTUBS=4*MXSBNP) 

PARAMETER(MXSJBD=27,MXSKBD=  16,MXSNTI= 1 0000,MXSDTC=20) 

PARAMETER(MXSMAT=  1  ,MXSSPPM=8,MXSMPPM=14) 

C  PARAMETER(MXSRMP=8) 

C 

C CONTROL  INTEGERS  FOR  3-D  FLOW  SOURCE/SINK  AND  BOUNDARY  CONDITIONS 

C 

C  MXSWNPF  :  MAX.  NO.  OF  POINT  SOURCES/SINKS 

C  MXSWPRF  :  MAX.  NO.  OF  PROFILES  USED  TO  DESCRIBED  POINT  SOURCES/SINKS 
C  MXSWDPF  :  MAX.  NO.  OF  DATA  POINTS  NEEDED  TO  DESCRIBE  ANY  POINT  SOURCE/SINK  PROFILE 
C  MXSCNPF  :  MAX.  NO.  OF  POINT  CAUCHY  BOUNDARY  NODES 
C  MXSCESF  :  MAX.  NO.  OF  CAUCHY  BOUNDARY  SIDES 

C  MXSCPRF  :  MAX.  NO.  OF  PROFILES  USED  TO  DESCRIBE  CAUCHY  BOUNDARY  CONDITIONS 
C  MXSCDFF  :  MAX.  NO.  OF  DATA  POINTS  NEEDED  TO  DESCRIBE  ANY  CAUCHY  BOUNDARY  PROFILE 
C  MXSNNPF  :  MAX.  NO.  OF  POINT  NEUMANN  BOUNDARY  NODES 
C  MXSNESF  :  MAX.  NO.  OF  NEUMANN  BOUNDARY  SIDES 

C  MXSNPRF  :  MAX.  NO.  OF  PROFILES  USED  TO  DESCRIBE  NEUMANN  BOUNDARY  CONDITIONS 
C  MXSNDPF  :  MAX.  NO.  OF  DATA  POINTS  NEEDED  TO  DESCRIBE  ANY  NEUMANN  BOUNDARY  PROFILE 
C  MXSVNPF  :  MAX.  NO.  OF  POINT  VARIABLE  BOUNDARY  NODES 
C  MXSVESF  :  MAX.  NO.  OF  VARIABLE  BOUNDARY  SIDES 

C  MXSVPRF  :  MAX.  NO.  OF  PROFILES  USED  TO  DESCRIBE  VARIABLE  BOUNDARY  CONDITIONS 
C  MXSVDPF  :  MAX.  NO.  OF  DATA  POINTS  NEEDED  TO  DESCRIBE  ANY  VARIABLE  BOUNDARY  PROFILE 
C  MXSDNPF  :  MAX.  NO.  OF  POINT  DIRICHLET  BOUNDARY  NODES 

C  MXSDPRF  :  MAX.  NO.  OF  PROFILES  USED  TO  DESCRIBE  DIRICHLET  BOUNDARY  CONDITIONS 
C  MXSDDPF  :  MAX.  NO.  OF  DATA  POINTS  NEEDED  TO  DESCRIBE  ANY  DIRICHLET  BOUNDARY  PROFILE 
C  MXSRNPF  :  MAX.  NO.  OF  POINT  RIVER  BOUNDARY  NODES 

C  MXSRPRF  :  MAX.  NO.  OF  PROFILES  USED  TO  DESCRIBE  RIVER  BOUNDARY  CONDITIONS 
C  MXSRDPF  :  MAX.  NO.  OF  DATA  POINTS  NEEDED  TO  DESCRIBE  ANY  RIVER  BOUNDARY  PROFILE 
C  MXSRMAF  :  MAX.  NO.  OF  BED  MATERIALS  ON  THE  RIVER  BOUNDARY 
C  MXSRESF  :  MAX.  NO.  OF  RIVER  BOUNDARY  SIDES. 

C 

PARAMETER(MXSWNPF=1,MXSWPRF=1,MXSWDPF=1) 

PARAMETER(MXSCNPF=1,MXSCESF=1,MXSCPRF=1,MXSCDPF=1) 

PARAMETER(MXSNNPF=  1  ,MXSNESF=  1  ,MXSNPRF=  1  ,MXSNDPF=  1 ) 

PARAMETER(MXSVNPF=500,MXSVESF=300,MXSVPRF=5>MXSVDPF=6) 

PARAMETER(MXSDNPF=300,MXSDPRF=4,MXSDDPF=6) 

PARAMETER(MXSRNPF=  1  ,MXSRPRF=  1  ,MXSRDPF=  1  ,MXSRMAF=  1  ,MXSRESF=  1 ) 

C 

C CONTROL  INTEGERS  FOR  3-D  TRANSPORT  SOURCE/SINK  AND  BOUNDARY  CONDITIONS 

C 

C  MXSWNPT  :  MAX.  NO.  OF  POINT  SOURCES/SINKS 

C  MXSWPRT  :  MAX.  NO.  OF  PROFILES  USED  TO  DESCRIBED  POINT  SOURCES/SINKS 
C  MXSWDPT  :  MAX.  NO.  OF  DATA  POINTS  NEEDED  TO  DESCRIBE  ANY  POINT  SOURCE/SINK  PROFILE 
C  MXSCNPT  :  MAX.  NO.  OF  POINT  CAUCHY  BOUNDARY  NODES 
C  MXSCEST  :  MAX.  NO.  OF  CAUCHY  BOUNDARY  SIDES 

C  MXSCPRT  :  MAX.  NO.  OF  PROFILES  USED  TO  DESCRIBE  CAUCHY  BOUNDARY  CONDITIONS 
C  MXSCDPT  :  MAX.  NO.  OF  DATA  POINTS  NEEDED  TO  DESCRIBE  ANY  CAUCHY  BOUNDARY  PROFILE 
C  MXSNNPT  :  MAX.  NO.  OF  POINT  NEUMANN  BOUNDARY  NODES 
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C  MXSNEST  :  MAX.  NO.  OF  NEUMANN  BOUNDARY  SIDES 

C  MXSNPRT  :  MAX.  NO.  OF  PROFILES  USED  TO  DESCRIBE  NEUMANN  BOUNDARY  CONDITIONS 
C  MXSNDPT  :  MAX.  NO.  OF  DATA  POINTS  NEEDED  TO  DESCRIBE  ANY  NEUMANN  BOUNDARY  PROFILE 
C  MXSVNPT  :  MAX.  NO.  OF  POINT  VARIABLE  BOUNDARY  NODES 
C  MXSVEST  :  MAX.  NO.  OF  VARIABLE  BOUNDARY  SIDES 

C  MXSVPRT  :  MAX.  NO.  OF  PROFILES  USED  TO  DESCRIBE  VARIABLE  BOUNDARY  CONDITIONS 
C  MXSVDPT  :  MAX.  NO.  OF  DATA  POINTS  NEEDED  TO  DESCRIBE  ANY  VARIABLE  BOUNDARY  PROFILE 
C  MXSDNPT  :  MAX.  NO.  OF  POINT  DIRICHLET  BOUNDARY  NODES 

C  MXSDPRT  :  MAX.  NO.  OF  PROFILES  USED  TO  DESCRIBE  DIRICHLET  BOUNDARY  CONDITIONS 
C  MXSDDPT  :  MAX.  NO.  OF  DATA  POINTS  NEEDED  TO  DESCRIBE  ANY  DIRICHLET  BOUNDARY  PROFILE 
C  MXSNPW  :  MAX.  NO.  OF  WORKING  NODES  USED  FOR  IMPLEMENTING  THE ‘IN-ELEMENT’ PARTICLE 
C  TRACKING 

C  MXSELW  :  MAX.  NO.  OF  WORKING  ELEMENTS  USED  FOR  IMPLEMENTING  THE  ‘IN-ELEMENT  PARTICLE 
C  TRACKING 

C 

PARAMETER(MXSWNPT=1  ,MXSWPRT=1,MXSWDPT=1 ) 

PARAMETER(MXSCNPT=lJvLXSCEST=lJvIXSCPRT=l,MXSCDPT=l) 

PARAMETER(MXSNNPT=1,MXSNEST=1,MXSNPRT=1,MXSNDPT=1) 

PARAMETER  (MXSVNPT=500,MXSVEST=400,MXSVPRT=3,MXSVDPT=5) 
PARAMETER(MXSDNPT=300,MXSDPRT=3,MXSDDPT=5) 

PARAMETER(MXSNPW=125,MXSELW=64) 

. MAXIMUM  DIMENSION  BLOCK  FOR  GRAPHIC  INTERFACE 


PARAMETER(MXPNTK=10,MXLINK=5,MXITPK=30) 

■  MAXIMUM  DIMENSION  BLOCK  FOR  1-D/2-D  MAPPING 

MXN12NK  :  MAX.  NO.  OF  OVERLAND  NODES  ASSOCIATED  WITH  A  RIVER 
NODE. 

PARAMETER  (MXN12NK=1 1) 
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Contaminant  and  sediment  transport 
Darcy’s  velocity 
Diffusion  wave 

Galerkin  finite  element  method 
Newton-Raphson  method 
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Picard  method 
Richard’s  equation 
Subsurface  flow 
Watershed  system 


